CLI 安装

Homebrew / 脚本安装、配对与平台说明

​

Starcat CLI 是什么

starcat-cli 是跨平台命令行客户端，并可作为 AI Agent 的 stdio MCP 桥：

• 不直接读取 Starcat SQLite
• 读写一律走 App 的 MCP Tools
• 权限、dry-run、Pro 校验、审计仍由 macOS 上的 Starcat App 执行

App 跑在 Mac；CLI 可装在同一台 Mac，或经可信网络连接已配对的 App。

​

安装

​

Homebrew

brew tap starcat-app/starcat-cli
brew install starcat

Tap 仓库：homebrew-starcat-cli。

​

macOS / Linux 一键脚本

curl -fsSL https://github.com/starcat-app/starcat-cli/releases/latest/download/install.sh | sh

默认装到 ~/.local/bin/starcat（可用 STARCAT_INSTALL_DIR 覆盖）。脚本会校验 SHA-256。

​

Windows PowerShell

irm https://github.com/starcat-app/starcat-cli/releases/latest/download/install.ps1 | iex

​

配对（必做）

1. 打开 App MCP

   Starcat → 设置 → MCP → 启用服务。需 Pro。
2. 复制配对命令

   在设置页复制；URI 约 5 分钟有效、单次兑换。
3. 终端执行

   starcat pair "starcat-pair://connect?..."
   starcat doctor
   
4. 回到 App 确认设备

   未确认则配对未完成。

也可运行 starcat pair 后粘贴 URI。长期凭据存系统钥匙串 / Credential Manager / Secret Service。

详见 MCP 设置。

​

验证

starcat --version
starcat doctor
starcat capabilities

​

下一步

• 使用指南
• Agent Skill
• Skill 仓库：starcat-skill