RAG workspace

Detached three-column window: questions, @ repo picker, timeline, citations, and index

Open (Pro)

Method	Notes
Shortcut	Default ⇧⌘K (changeable → Shortcuts)
Toolbar	“Knowledge base Q&A”
Other	Knowledge base page / related Smart Collection

Prerequisites:

1. Pro
2. Chat + Embedding configured under Settings → AI
3. At least some ingested repos in the knowledge base

Three-column layout

┌────────────┬─────────────────────┬──────────────────┐
│ Sessions   │ Q&A stream +        │ Citations /      │
│ New / pin  │ execution timeline  │ plan / index     │
│            │ Composer + @        │ Evidence / Index │
└────────────┴─────────────────────┴──────────────────┘

• Left and right columns are resizable; width often restores on reopen
• Center column shows retrieve / plan / generate steps while running; you can collapse manually

Question flow

1. Write your question

   Be specific. For example:

   • “Among repos in my knowledge base for local-first sync, what conflict strategies exist?”
   • “@foo/bar @baz/qux — how do I choose between these for embedded use?”
2. @ pick repos (optional)

   Type @ to open the knowledge-base repo picker; multi-select; remove chips at the top. Used for only / prefer / exclude style scope (per UI semantics).

3. Send

   Watch the timeline; wait for streaming or segmented output.

4. Verify citations

   Click citation chips in the answer → evidence on the right. See Citations & evidence.

Default retrieval scope

Ingested repositories only—not “starred but not ingested.”

When empty, onboarding points you to Smart Collections, Search, or Explore to ingest. See Adding repos.

Live web context

If External Search is enabled as live context:

• Successful runs may mix in web evidence
• Failures may surface a card pointing to Settings → Integrations → External Search

See External search.

Read-only by design

The workspace is Q&A-first: it does not change tags / notes / status without confirmation. To mutate data, use organize UI or CLI --apply.

Sessions and export

Manage history in the left column; export Markdown. See Session management.

Unhealthy index

Low coverage in the header or “no index” hints → Index management.

Related

• Knowledge base overview
• AI configuration
• FAQ · AI