Core Concept: Spaces
Spaces are Rephlo's knowledge bases. They allow you to "teach" the AI about your specific projects, documents, or style guides. When a Space is active, Rephlo reads from it to provide answers that are accurate and relevant to you.
What is a Space?
Think of a Space as a Folder of reference materials.
- Without a Space: The AI relies only on its general training (e.g., "Write a contract").
- With a Space: The AI uses your files (e.g., "Write a contract using the terms in my uploaded PDF").
Supported Data Types
You can import various file types into a Space:
- Documents:
.pdf,.docx,.txt,.md - Code:
.cs,.py,.js,.json, etc. - Logs:
.log
How It Works (Full Context Injection)
Rephlo uses Full Context Injection to give the AI access to your documents.
- Ingestion: You add files to a Space. Rephlo extracts and stores their text content.
- Injection: When you run a Command, Rephlo includes all Space content in the prompt sent to the AI.
- Generation: The AI reads the full context and generates answers based on everything in the Space.
┌─────────────────────────────────────────────────────────────────────────┐
│ FULL CONTEXT INJECTION │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ STEP 1: INGESTION │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ PDF │ │ DOCX │ │ TXT │ │
│ │ report.pdf │ │ notes.docx │ │ readme.txt │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ └────────────────────┼────────────────────┘ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ SPACE │ │
│ │ "Q3 Analysis" │ │
│ │ ┌───────────┐ │ │
│ │ │ Stored │ │ │
│ │ │ Content │ │ │
│ │ └───────────┘ │ │
│ └────────┬────────┘ │
│ │ │
│ STEP 2: INJECTION │ │
│ ┌──────────────┐ │ │
│ │ Your Query: │ │ │
│ │ "What was │───────────┤ │
│ │ the Q3 │ │ │
│ │ revenue?" │ │ │
│ └──────────────┘ │ │
│ │ │
│ STEP 3: GENERATION │ ALL content injected │
│ ▼ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ AI Provider │ │
│ │ ┌─────────────┐ + ┌─────────────┐ = ┌────────────┐ │ │
│ │ │ Your Query │ │ ALL Space │ │ Accurate │ │ │
│ │ │ │ │ Documents │ │ Answer │ │ │
│ │ └─────────────┘ └─────────────┘ └────────────┘ │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
💡 Future Enhancement: RAG (Retrieval Augmented Generation) with semantic search is planned for a future release, enabling intelligent retrieval of only the most relevant document sections.
Token Budget & Compaction
LLMs have a limit on how much text they can read at once (Context Window). Spaces manage this automatically:
- Token Budget: Each Space tracks how much "room" its documents take up.
- Smart Compaction: If a Space gets too big, Rephlo can use an AI model to summarize older or less critical documents, keeping the core information while freeing up space. This ensures you never run out of context.
Managing Spaces
- Active Space: You can only have one Space "Active" at a time per interaction.
- Switching: You can switch Spaces instantly from the Dashboard or Command Runner to change context (e.g., switching from "Project A" context to "Personal Finance" context).
┌─────────────────────────────────────────────────────────────────────────┐
│ SPACE MANAGEMENT PANEL │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Spaces [+ New Space] │ │
│ ├─────────────────────────────────────────────────────────────────┤ │
│ │ │ │
│ │ ┌─────────────────────────────────────────────────────────┐ │ │
│ │ │ [*] Q3 Analysis ACTIVE │ │ │
│ │ │ 3 files | 2,450 tokens │ │ │
│ │ │ Last updated: 2 hours ago │ │ │
│ │ └─────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌─────────────────────────────────────────────────────────┐ │ │
│ │ │ [ ] Project Docs │ │ │
│ │ │ 12 files | 8,200 tokens │ │ │
│ │ │ Last updated: 1 day ago │ │ │
│ │ └─────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌─────────────────────────────────────────────────────────┐ │ │
│ │ │ [ ] Style Guide │ │ │
│ │ │ 1 file | 890 tokens │ │ │
│ │ │ Last updated: 1 week ago │ │ │
│ │ └─────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ───────────────────────────────────────────────────────── │ │
│ │ Total: 3 Spaces | 11,540 tokens used │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Next Concept: Learn about Providers – the engines powering the AI.