Skip to Content
Spaces

Spaces

A Space is TARX’s unit of context — a persistent container for files, memories, and conversations grouped around a project.

What’s in a Space?

ComponentDescription
FilesIndexed documents, code, images — RAG-embedded
MemoriesDecisions, notes, facts — semantic search
ConversationsSession summaries with key decisions
ContextComputed project state for AI sessions

Creating a Space

Spaces are created automatically when you:

  • Upload files to a project in the TARX sidebar
  • Use tarx_remember with a context field
  • Save a conversation with tarx_save_conversation

Listing Spaces

Via MCP:

{
  "tool": "tarx_list_spaces"
}

Returns:

{
  "spaces": [
    { "id": "sp_abc123", "name": "tarx-web", "created_at": "2026-03-01" },
    { "id": "sp_def456", "name": "quantum-research", "created_at": "2026-02-15" }
  ]
}

Listing Files in a Space

{
  "tool": "tarx_list_files",
  "arguments": { "space_id": "sp_abc123" }
}

Loading Project Context

{
  "tool": "tarx_project_context",
  "arguments": { "project": "tarx-web", "depth": "full" }
}

This returns files, recent decisions, and activity — everything an AI needs to understand your project before responding.

Storage

All Space data lives locally in SQLite (memory.db) and on disk (tarx/files/). RAG embeddings enable semantic search across all content in a Space.

Last updated on
ArchitectureSkills