Notes and status

Private on-device Markdown notes, and unread / read / using

Purpose

Each repository can have a local-only note: why you starred it, what broke, how you plan to use it. The body is indexed for local search. Collaborators on GitHub never see it.

Status has three values for triage:

Status	Meaning
unread	Not handled yet; common default for new Stars
read	You have seen the README / you understand it
using	You actually depend on it in a project

Detail: private note Markdown preview and status capsule

Screenshot TODO · images/screenshots/manage-stars/notes-status.webp

How to write notes

1. Select a repo and open Private notes on the right
2. Write Markdown on the Edit tab; switch to Preview as needed
3. Watch the autosave indicator; it writes local SQLite

Successful writes from the browser extension or MCP/CLI refresh the pane.

AI generate (Pro): Generate with AI in the notes header produces a draft. Nothing is saved until you confirm. See AI personal notes.

Status

In detail: tap unread / read to enter using; tap × on using to return to read.

Filter via Filters. After CLI pairing:

starcat repo status set owner/repo using --apply

See CLI.

Marking using may ask whether to ingest for RAG. Ingest, Star, and status are independent. See Ingest.

Notes

• Notes are not on GitHub. Moving Macs requires backup.
• Unsaved drafts are not list-searchable.

Related

• Tags
• List search