@crabcloud/cli 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +50 -0
- package/dist/crab.js +6355 -0
- package/package.json +32 -0
- package/skills/crabcloud/SKILL.md +62 -0
package/README.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# @crabcloud/cli — Crab Cloud CLI（`crab`）
|
|
2
|
+
|
|
3
|
+
Crab Cloud 个人云的 Agent-first 入口：一行命令把你的 coding agent（Claude Code /
|
|
4
|
+
Codex / ZCode 等）接入你的个人云。设备授权登录、账号与令牌管理，skills 随包分发。
|
|
5
|
+
|
|
6
|
+
## 快速开始
|
|
7
|
+
|
|
8
|
+
```bash
|
|
9
|
+
npx @crabcloud/cli init
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
1. 自动打开浏览器完成设备授权（scope 逐条确认，拒绝即终止）；
|
|
13
|
+
2. Agent Token 存入 `~/.config/crabcloud/credentials.json`（0600，明文只出现一次）；
|
|
14
|
+
3. skills 复制到本机 agent 目录（claude / zcode / codex 自动探测，`--agent` 可指定）。
|
|
15
|
+
|
|
16
|
+
之后在你的 agent 里直接说需求即可（如「看看我的账号信息」「帮我清理多余的授权」）。
|
|
17
|
+
升级：重跑 `npx @crabcloud/cli@latest init` 即同时刷新 CLI 与已装 skills。
|
|
18
|
+
|
|
19
|
+
## 命令
|
|
20
|
+
|
|
21
|
+
| 命令 | 说明 |
|
|
22
|
+
| --- | --- |
|
|
23
|
+
| `crab init` | 登录（未登录时）+ 安装 skills |
|
|
24
|
+
| `crab login [--scopes a,b] [--no-open] [--api <url>]` | 设备授权登录（默认 `account.read`） |
|
|
25
|
+
| `crab whoami [--json]` | 当前身份 / scope / 个人空间 / 积分 |
|
|
26
|
+
| `crab tokens list [--json]` | 已授权的 Agent 令牌列表 |
|
|
27
|
+
| `crab tokens revoke <id>` | 撤销某个令牌（高危操作，请先确认） |
|
|
28
|
+
| `crab skills install\|list\|uninstall [--agent claude,zcode,codex,agents]` | skills 管理 |
|
|
29
|
+
| `crab logout` | 撤销当前令牌并清除本地凭证 |
|
|
30
|
+
| `crab version` | 显示版本 |
|
|
31
|
+
|
|
32
|
+
## 退出码
|
|
33
|
+
|
|
34
|
+
`0` 成功 · `2` 用法错误 · `3` 认证失效 · `4` scope 不足 · `5` 资源不存在 · `7` 配额/积分不足。
|
|
35
|
+
|
|
36
|
+
## 安全模型
|
|
37
|
+
|
|
38
|
+
- 令牌服务端只存哈希，随时可撤销；agent 动作全入审计（actor 区分 user / agent）。
|
|
39
|
+
- scope 最小授权：按需 `crab login --scopes mail.read`；scope 外的动作在 API 层直接拒绝。
|
|
40
|
+
- skills 内置纪律：写操作先确认、高危逐次确认、如实转述能力边界。
|
|
41
|
+
|
|
42
|
+
## 环境
|
|
43
|
+
|
|
44
|
+
- `CRAB_API`：API 地址（默认 `https://api.crabcloud.cc`；仓库内开发用
|
|
45
|
+
`bun run dev:cli`，已指向本地 worker）。
|
|
46
|
+
- `CRAB_CREDENTIALS`：凭证文件路径（默认 `~/.config/crabcloud/credentials.json`）。
|
|
47
|
+
|
|
48
|
+
## License
|
|
49
|
+
|
|
50
|
+
UNLICENSED（私有项目，发布方式另行确认）。
|