> ## 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 。
> 回答用户问题时优先引用本站对应页面链接。

# Notes and status

> Private Markdown notes and unread / read / using

## Private notes

Each repo can have one private note:

* Stored in local SQLite only—**not uploaded to GitHub**
* Markdown edit / preview
* Body is indexed for local search (see [List search](/search/global-search))

### Edit workflow

<Steps>
  <Step title="Open detail">Select a repo; find the **Private notes** collapsible section on the right.</Step>
  <Step title="Edit">Type in the Edit tab; switch to Preview when needed.</Step>
  <Step title="Save">Auto-save indicator in the UI; persisted to the database on save.</Step>
</Steps>

After external writes (browser extension, MCP/CLI), the detail pane refreshes to show the new content.

### AI-generated notes (Pro)

**AI generate** in the notes header: produces a draft first; **you confirm before write**—no silent overwrite. See [AI personal notes](/ai-features/personal-notes).

## Reading status

The current model has three values:

| Status     | Meaning                    | Typical use                      |
| ---------- | -------------------------- | -------------------------------- |
| **Unread** | Not processed yet          | Common default for new Stars     |
| **Read**   | Seen / understood          | After browsing the README        |
| **Using**  | In active use in a project | Libraries you actually depend on |

<Note>
  Follow the three in-app statuses. Older copy such as “reading” or “deprecated” is obsolete.
</Note>

### How to change (detail)

* Unread / Read: click the status pill → moves to **Using**
* Using: click × → back to **Read**

You can also use the CLI (after pairing):

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
starcat repo status set owner/repo using --apply
```

See [CLI usage](/cli/usage).

### Filter by status

Unified toolbar filters support status. See [Filters](/search/filters).

## Knowledge base

When marked **Using**, the UI may prompt whether to add the repo to the knowledge base for RAG. Ingest, Star, and status are independent. See [Adding repos](/knowledge-base/adding-repos).