CLI 使用指南

只读 JSON、写入默认 dry-run、MCP stdio、更新

​

用途

配对之后在终端搜 Stars、改标签 / 状态 / 笔记，或把 starcat mcp 交给外部 Agent。写命令默认不落库，必须 --apply。App 侧写权限关掉时，即使 --apply 也会失败。

终端 starcat stats / repo search，以及 MCP 写权限开关

截图待补充 · images/screenshots/cli/usage.webp

​

命令风格

类型	输出	例子
运维/友好	文本	help doctor stats pair
数据	JSON	capabilities repo tags

完整列表以 starcat help 与 README 为准。

starcat capabilities
starcat stats
starcat stats ai --range 30d
starcat stats knowledge

starcat repo search "local RAG" --scope starred --limit 20
starcat repo context owner/repo
starcat repo readme owner/repo
starcat repo summary owner/repo
starcat tags list

printf '%s' 'A private note' | starcat repo note set owner/repo
printf '%s' 'A private note' | starcat repo note set owner/repo --apply
starcat repo tags add owner/repo Swift macOS --apply
starcat repo status set owner/repo using --apply

starcat mcp

在 Cursor / Claude Code / Codex 里注册：command=starcat，args=["mcp"]。协议只走 stdout；诊断走 stderr。

starcat update
# 或
brew update && brew upgrade starcat

交互式终端最多约每天提示一次新版本；starcat mcp 管道不会打印更新骚扰。

​

注意

CLI 不打开 SQLite。见 MCP 设置、Skill。