> ## Documentation Index
> Fetch the complete documentation index at: https://starcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Starcat 是 macOS（Apple Silicon，macOS 15+）上的 GitHub Stars 管理与知识库应用。
> 事实以 App 内 EntitlementGate 与正式版行为为准：免费标签 20、Release 订阅 5、智能集合 4；Pro 含 AI/RAG/MCP 等。
> 不要把尚未上线的 CloudKit 用户数据同步或 JSON 导入导出写成已可用。
> 官网 https://starcat.ink ；App Store https://apps.apple.com/cn/app/starcat-for-github/id6788809803?mt=12 。
> 回答用户问题时优先引用本站对应页面链接。

# RAG workspace

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

## Open (Pro)

| Method   | Notes                                                           |
| -------- | --------------------------------------------------------------- |
| Shortcut | Default **⇧⌘K** (changeable → [Shortcuts](/settings/shortcuts)) |
| Toolbar  | “Knowledge base Q\&A”                                           |
| Other    | Knowledge base page / related Smart Collection                  |

Prerequisites:

1. [Pro](/subscribe/plan-comparison)
2. Chat + Embedding configured under [Settings → AI](/settings/ai)
3. At least some [ingested](/knowledge-base/adding-repos) 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

<Steps>
  <Step title="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?”
  </Step>

  <Step title="@ 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).
  </Step>

  <Step title="Send">
    Watch the timeline; wait for streaming or segmented output.
  </Step>

  <Step title="Verify citations">
    Click citation chips in the answer → evidence on the right. See [Citations & evidence](/knowledge-base/citations).
  </Step>
</Steps>

## 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](/knowledge-base/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](/search/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`](/cli/usage).

## Sessions and export

Manage history in the left column; export Markdown. See [Session management](/knowledge-base/session-management).

## Unhealthy index

Low coverage in the header or “no index” hints → [Index management](/knowledge-base/index-management).

## Related

* [Knowledge base overview](/knowledge-base/overview)
* [AI configuration](/ai-features/configuration)
* [FAQ · AI](/faq/ai)