alink-cli 0.6.2 → 0.7.1

package/README.md

@@ -1,59 +1,25 @@
-# agentlink
+# alink-cli
 
-在工作机上**一条命令**把本机接入 [AgentLink](https://github.com/baichen99/agentlink)，随时随地从手机 / 网页遥控本机安装的编码 agent（Claude Code / Codex CLI / JoyCode）。连接是**出站**的——走 NAT / 防火墙无需端口转发、无需 VPN，断线自动重连。
-
-One command on your work machine links it to AgentLink so you can drive your local coding agents (Claude Code / Codex CLI / JoyCode) from anywhere. The connection dials **out**, so it just works behind NAT/firewalls; it reconnects automatically.
-
-## Quick start
-
-在控制台“添加机器”拿到机器凭证（`al1.…` 整串），然后在工作机上：
-
-```bash
-npx alink-cli --token al1.xxxxxxxx
-```
-
-首次成功连上后，凭证会存到 `~/.agentlink/credential`（权限 `0600`）。之后在同一台机器上**直接裸跑**即可，命令行 token 只需出现这一次；裸跑会默认转入后台，日志在 `~/.agentlink/daemon.log`：
+一条命令把当前电脑上的 Claude Code、Codex、Gemini、Qwen、Kimi 等编码 agent 接入 AgentLink。
 
 ```bash
 npx alink-cli
 ```
 
-需要手动改凭证时：
+首次运行会在本机生成 E2EE 密钥并打印二维码；在 `https://link.harmopath.com` 登录 GitHub 后扫码或粘贴即可。凭证保存到 `~/.agentlink/credential`（`0600`），之后重复同一命令即可上线。
 
 ```bash
-npx alink-cli credential set al1.xxxxxxxx
-npx alink-cli credential show
-npx alink-cli credential clear
+npx alink-cli --hub wss://your-hub.example.com
+npx alink-cli --dir /path/to/project
+npx alink-cli --pair
+npx alink-cli qr
+npx alink-cli credential status
 ```
 
-## 参数 Options
-
-| 参数 | 说明 | 默认值 |
-| --- | --- | --- |
-| `--token <token>` | 机器凭证（控制台生成的 `al1.…` 整串）。也可用环境变量 `AGENTLINK_TOKEN` 提供（`--token` 优先）。 | 依次取 `AGENTLINK_TOKEN` → `~/.agentlink/credential` |
-| `--hub <wss://…>` | 要连接的 hub 地址。 | `wss://link.harmopath.com`（官方 hub） |
-| `--dir <path>` | 工作目录根，可重复给多次；运行时可用其下任意子目录，网页里以目录树浏览。 | 当前目录 `process.cwd()` |
-| `--tunnel` | 不连任何 hub：本地起一个 hub + 免费 Cloudflare 隧道，打印公网链接（需 `cloudflared`）。与 `--hub` 互斥。 | — |
-| `credential [status|path|show|set|clear]` | 查看路径、明文显示、手动覆盖或删除本机保存的凭证。 | `~/.agentlink/credential` |
-| `qr` | 在终端打印本机凭证二维码，同时输出整串凭证供手动粘贴。 | 读取已保存凭证 |
-| `status` / `logs -f` / `stop` / `restart` | 查看、跟随日志、停止或重启后台 daemon。 | — |
-| `--help`, `-h` | 显示用法。 | — |
-
-## 自建 hub Self-hosting
-
-连自己的 [agentlink-hub](https://www.npmjs.com/package/agentlink-hub) 时给 `--hub` 即可；单租户 hub 不需要预先铸凭证——不带 `--token` 时会自动生成一个并打印访问链接：
-
-```bash
-npx alink-cli --hub wss://your-host:8080
-#   → prints: open https://your-host:8080/?token=<uuid>
-```
-
-Point `--hub` at your own hub to skip the official one entirely. Against a single-tenant hub no minted credential is needed — without `--token` a fresh one is generated and the access link printed. The connection is **outbound** (works behind NAT, no port forwarding) and reconnects automatically; use `wss://` (TLS) for anything public.
-
-## 凭证与端到端加密 Credential & E2EE
-
-凭证是这台机器的**远程执行凭据**，请妥善保管：公网请务必用 `wss://`（TLS）。多租户凭证（`al1.` 前缀）里的第四段是端到端加密（E2EE）主密钥——它**只留在本机、从不上网**，daemon 把它单独归档到 `~/.agentlink/enckeys.json`（`0600`），hub 永远只看到密文。撤销某台机器：在控制台里重新添加即可让旧凭证失效。
-
-The credential grants remote code execution on this machine — keep it safe and use `wss://` (TLS) on any public hub. The trailing segment of an `al1.` credential is the end-to-end encryption key; it never leaves this machine, so the hub only ever sees ciphertext.
+- `--hub`：Hub 地址，默认 `wss://link.harmopath.com`。
+- `--dir`：默认工作目录，缺省为当前目录。
+- `--pair`：忽略已保存凭证并重新配对。
+- `--token`：导入完整机器凭证。
+- `--legacy`：临时运行旧 daemon；默认始终是 daemon-t3。
 
-完整文档 Full docs: [github.com/baichen99/agentlink](https://github.com/baichen99/agentlink) · MIT
+Node.js 22.16+。连接为出站 WebSocket，无需端口转发；Hub 只转发 E2EE 密文。