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

# CLI 安装

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

## Starcat CLI 是什么

[`starcat-cli`](https://github.com/starcat-app/starcat-cli) 是跨平台命令行客户端，并可作为 AI Agent 的 **stdio MCP** 桥：

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

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

## 安装

### Homebrew

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
brew tap starcat-app/starcat-cli
brew install starcat
```

Tap 仓库：[`homebrew-starcat-cli`](https://github.com/starcat-app/homebrew-starcat-cli)。

### macOS / Linux 一键脚本

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```powershell theme={"theme":{"light":"github-light","dark":"github-dark"}}
irm https://github.com/starcat-app/starcat-cli/releases/latest/download/install.ps1 | iex
```

## 配对（必做）

<Steps>
  <Step title="打开 App MCP">Starcat → **设置 → MCP** → 启用服务。需 [Pro](/zh-Hans/subscribe/plan-comparison)。</Step>
  <Step title="复制配对命令">在设置页复制；URI 约 5 分钟有效、单次兑换。</Step>

  <Step title="终端执行">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    starcat pair "starcat-pair://connect?..."
    starcat doctor
    ```
  </Step>

  <Step title="回到 App 确认设备">未确认则配对未完成。</Step>
</Steps>

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

详见 [MCP 设置](/zh-Hans/settings/mcp)。

## 验证

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
starcat --version
starcat doctor
starcat capabilities
```

## 下一步

* [使用指南](/zh-Hans/cli/usage)
* [Agent Skill](/zh-Hans/cli/skill)
* Skill 仓库：[starcat-skill](https://github.com/starcat-app/starcat-skill)