alink-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agentlink contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# agentlink
+
+在工作机上**一条命令**把本机接入 [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 只需出现这一次：
+
+```bash
+npx alink-cli
+```
+
+## 参数 Options
+
+| 参数 | 说明 | 默认值 |
+| --- | --- | --- |
+| `--token <token>` | 机器凭证（控制台生成的 `al1.…` 整串）。也可用环境变量 `AGENTLINK_TOKEN` 提供（`--token` 优先）。 | 依次取 `AGENTLINK_TOKEN` → `~/.agentlink/credential` |
+| `--hub <wss://…>` | 要连接的 hub 地址。 | `wss://link.harmopath.com`（官方 hub） |
+| `--dir <path>` | 工作目录根，可重复给多次；运行时可用其下任意子目录，网页里以目录树浏览。 | 当前目录 `process.cwd()` |
+| `--help`, `-h` | 显示用法。 | — |
+
+## 凭证与端到端加密 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.
+
+完整文档 Full docs: [github.com/baichen99/agentlink](https://github.com/baichen99/agentlink) · MIT

package/bin/agentlink.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+// bin/agentlink.js — `npx alink-cli` 的薄入口。
+//
+// 它自己几乎不做事：把命令行参数补齐默认值后，直接 import 打好的 daemon
+// bundle（dist/daemon.js），由 daemon 完成探测 agent、连 hub、跑任务这套完整
+// 流程。daemon 在被 import 时会读 `process.argv` / `AGENTLINK_TOKEN`，所以这里
+// 必须在 import 之前把 argv 和 env 准备好。
+//
+// 相对 daemon 收敛的默认值（让工作机上一条命令即接入官方 hub）：
+//   --hub   缺省 wss://link.harmopath.com（daemon 裸跑缺省是 localhost，只适合开发）
+//   --dir   缺省 process.cwd()（daemon 本就如此，无需干预）
+//   --token 缺省依次取 AGENTLINK_TOKEN 环境变量 → ~/.agentlink/credential 落盘凭证
+//
+// 凭证落盘：首次带 `--token` 成功连上 hub 后，把整串 token 写到
+// ~/.agentlink/credential（0600）。之后裸跑 `npx alink-cli` 直接复用——命令行
+// 上的 token 只需出现一次。al1. 多租户凭证的第四段（E2EE 主密钥）也一并存进这
+// 个文件，从不上网；daemon 另会把它单独归档进 enckeys.json 供 E2EE 层使用。
+
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const OFFICIAL_HUB = "wss://link.harmopath.com";
+
+// 凭证文件与 daemon 的状态目录同根（默认 ~/.agentlink，可用 AGENTLINK_STATE_DIR
+// 覆盖，测试用），文件名固定为 credential。
+const STATE_DIR = process.env.AGENTLINK_STATE_DIR || join(homedir(), ".agentlink");
+const CREDENTIAL_FILE = join(STATE_DIR, "credential");
+
+const rawArgs = process.argv.slice(2);
+
+// --help / -h：打印简洁中文用法后退出，不启动 daemon。
+if (rawArgs.includes("--help") || rawArgs.includes("-h")) {
+  printHelp();
+  process.exit(0);
+}
+
+// 判断某个具名参数是否已由用户给出（同时认 `--name value` 与 `--name=value`）。
+function hasFlag(name) {
+  return rawArgs.some((a) => a === `--${name}` || a.startsWith(`--${name}=`));
+}
+
+// 读取具名参数的值（用于取出用户显式给的 --token 整串）。
+function flagValue(name) {
+  for (let i = 0; i < rawArgs.length; i++) {
+    const a = rawArgs[i];
+    if (a === `--${name}`) return rawArgs[i + 1];
+    if (a.startsWith(`--${name}=`)) return a.slice(name.length + 3);
+  }
+  return undefined;
+}
+
+function readCredentialFile() {
+  try {
+    const t = readFileSync(CREDENTIAL_FILE, "utf-8").trim();
+    return t || undefined;
+  } catch {
+    return undefined; // 文件不存在或不可读——当作没有凭证
+  }
+}
+
+function persistCredential(token) {
+  mkdirSync(STATE_DIR, { recursive: true });
+  // 先写再 chmod，确保即便文件是新建也是 0600（mode 选项只在创建时生效）。
+  writeFileSync(CREDENTIAL_FILE, token, { mode: 0o600 });
+  chmodSync(CREDENTIAL_FILE, 0o600);
+}
+
+// --tunnel 模式下 daemon 会自起本地 hub，且与 --hub 互斥，所以此时绝不注入 --hub。
+const tunnelMode = hasFlag("tunnel");
+
+// 1) 补 --hub 默认值：官方 hub。
+if (!hasFlag("hub") && !tunnelMode) {
+  rawArgs.push("--hub", OFFICIAL_HUB);
+}
+
+// 2) 解析 token 来源，并决定是否需要“成功连接后落盘”。
+//    优先级：命令行 --token > AGENTLINK_TOKEN 环境变量 > 凭证文件。
+let tokenToPersist; // 仅当用户这次显式给了新 --token 时，连上后写盘
+const explicitToken = hasFlag("token") ? flagValue("token") : undefined;
+if (explicitToken) {
+  // 用户显式给了 token——daemon 会直接用 argv 里的 --token。若它和已存凭证不同，
+  // 安排在成功连上 hub 后落盘（避免把连不上的坏 token 也存下来）。
+  if (explicitToken !== readCredentialFile()) tokenToPersist = explicitToken;
+} else if (process.env.AGENTLINK_TOKEN) {
+  // 环境变量已给——daemon 自己会读 AGENTLINK_TOKEN，这里什么都不用做。
+} else {
+  // 命令行和环境变量都没有——回落到落盘凭证（若有），塞进 AGENTLINK_TOKEN 供
+  // daemon 读取。都没有时不注入：daemon 会生成随机 token 走单机模式并打印配对链接。
+  const saved = readCredentialFile();
+  if (saved) process.env.AGENTLINK_TOKEN = saved;
+}
+
+// 3) 把补好默认值的 argv 交还给 daemon（daemon 读 process.argv.slice(2)）。
+process.argv = [process.argv[0], process.argv[1], ...rawArgs];
+
+// 4) 若需要落盘：daemon 用 console.log 打印进度，成功连上时会输出
+//    "[daemon] registered. …"。在 import daemon 前挂一个一次性的 stdout 嗅探器，
+//    看到该标记即把 token 写盘，然后还原 stdout。这样只有真正连上的凭证才落盘。
+if (tokenToPersist) {
+  const original = process.stdout.write.bind(process.stdout);
+  let filed = false;
+  process.stdout.write = (chunk, ...rest) => {
+    if (!filed && typeof chunk === "string" && chunk.includes("[daemon] registered.")) {
+      filed = true;
+      try {
+        persistCredential(tokenToPersist);
+        original(`[agentlink] 凭证已保存到 ${CREDENTIAL_FILE}（0600）——之后可直接裸跑 \`npx alink-cli\`\n`);
+      } catch {
+        original(`[agentlink] 警告：凭证写入 ${CREDENTIAL_FILE} 失败——下次仍需 --token\n`);
+      }
+      process.stdout.write = original; // 还原，之后正常输出
+    }
+    return original(chunk, ...rest);
+  };
+}
+
+// 5) 启动 daemon。import 求值时它就会解析 argv 并开始连 hub。
+const daemon = new URL("../dist/daemon.js", import.meta.url);
+await import(daemon.href);
+
+function printHelp() {
+  const self = "agentlink";
+  process.stdout.write(
+    [
+      `用法: npx ${self} [--token <al1.…>] [--hub <wss://…>] [--dir <目录>]…`,
+      ``,
+      `把当前这台工作机接入 AgentLink，随时随地遥控本机的编码 agent。`,
+      ``,
+      `参数:`,
+      `  --token <token>  机器凭证（控制台里“添加机器”生成的 al1.… 整串）。`,
+      `                   首次成功连上后会存到 ~/.agentlink/credential（0600），`,
+      `                   之后裸跑 npx ${self} 自动复用。也可用环境变量`,
+      `                   AGENTLINK_TOKEN 提供（--token 优先）。`,
+      `  --hub <url>      hub 地址，缺省官方 hub ${OFFICIAL_HUB}。`,
+      `  --dir <path>     工作目录根，可重复；缺省当前目录。运行时可用其下任意子目录。`,
+      `  --help, -h       显示本帮助。`,
+      ``,
+      `示例:`,
+      `  npx ${self} --token al1.xxxxx      # 首次接入，token 只需给这一次`,
+      `  npx ${self}                        # 之后裸跑，复用已存凭证`,
+      ``,
+      `连接是出站的（走 NAT/防火墙无需端口转发），断线自动重连。al1. 凭证的加密`,
+      `密钥段只留在本机、从不上网（端到端加密）。`,
+      ``,
+    ].join("\n"),
+  );
+}