@crabcloud/cli — Crab Cloud CLI（crab）
Crab Cloud 个人云的 Agent-first 入口：一行命令把你的 coding agent（Claude Code / Codex / ZCode 等）接入你的个人云。设备授权登录、账号与令牌管理，skills 随包分发。
快速开始
npx @crabcloud/cli init
- 自动打开浏览器完成设备授权（scope 逐条确认，拒绝即终止）；
- Agent Token 存入
~/.config/crabcloud/credentials.json（0600，明文只出现一次）； - skills 复制到本机 agent 目录（claude / zcode / codex 自动探测，
--agent可指定）。
之后在你的 agent 里直接说需求即可（如「看看我的账号信息」「帮我清理多余的授权」）。
升级：重跑 npx @crabcloud/cli@latest init 即同时刷新 CLI 与已装 skills。
命令
| 命令 | 说明 |
|---|---|
crab init | 登录（未登录时）+ 安装 skills |
crab login [--scopes a,b] [--no-open] [--api <url>] | 设备授权登录（默认 account.read） |
crab whoami [--json] | 当前身份 / scope / 个人空间 / 积分 |
crab tokens list [--json] | 已授权的 Agent 令牌列表 |
crab tokens revoke <id> | 撤销某个令牌（高危操作，请先确认） |
crab skills install|list|uninstall [--agent claude,zcode,codex,agents] | skills 管理 |
crab logout | 撤销当前令牌并清除本地凭证 |
crab version | 显示版本 |
退出码
0 成功 · 2 用法错误 · 3 认证失效 · 4 scope 不足 · 5 资源不存在 · 7 配额/积分不足。
安全模型
- 令牌服务端只存哈希，随时可撤销；agent 动作全入审计（actor 区分 user / agent）。
- scope 最小授权：按需
crab login --scopes mail.read；scope 外的动作在 API 层直接拒绝。 - skills 内置纪律：写操作先确认、高危逐次确认、如实转述能力边界。
环境
CRAB_API：API 地址（默认https://api.crabcloud.cc；仓库内开发用bun run dev:cli，已指向本地 worker）。CRAB_CREDENTIALS：凭证文件路径（默认~/.config/crabcloud/credentials.json）。
License
UNLICENSED（私有项目，发布方式另行确认）。