cli-link 0.0.7 → 0.0.8
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 +56 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,18 +1,60 @@
|
|
|
1
|
-
# AgentPilot -
|
|
1
|
+
# AgentPilot - 手机远程访问本机 Codex CLI
|
|
2
2
|
|
|
3
|
-
AgentPilot
|
|
3
|
+
AgentPilot（npm 包 `cli-link`）提供一个手机端入口，把运行在个人电脑或开发机上的 Codex CLI 变成可以远程访问的工作台。你继续使用本机仓库、依赖、终端登录态和网络环境，手机上负责发任务、看输出、补充指令、处理确认和查看代码变更。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
它不是替代 Codex CLI 的新 Agent，也不是把代码搬到云端运行。AgentPilot 做的是把本机 Codex CLI 的交互、状态和工作区能力延伸到手机，让你离开电脑后仍能继续遥控本机任务。当前也兼容 Claude Code CLI；本文以 Codex CLI 场景为主。
|
|
6
|
+
|
|
7
|
+
## 工具定位
|
|
8
|
+
|
|
9
|
+
AgentPilot 面向“本机运行、手机访问”的使用方式：
|
|
10
|
+
|
|
11
|
+
- 在本机完整开发环境里启动 Codex CLI。
|
|
12
|
+
- 通过手机浏览器远程查看执行进度、工具调用、命令输出和最终回复。
|
|
13
|
+
- 当 Codex CLI 等待确认或补充信息时，在手机上直接处理。
|
|
14
|
+
- 在代码页面查看当前工作目录、Git 变更和文件 diff，必要时完成暂存和提交。
|
|
15
|
+
- 通过历史记录复盘任务，或继续向可恢复的会话追问。
|
|
16
|
+
|
|
17
|
+
只要电脑保持开机、联网且 AgentPilot 服务未退出，就可以面向远程 24 小时访问；如果是 Mac，建议接入电源，并按本文后面的防休眠说明完成系统设置。
|
|
18
|
+
|
|
19
|
+
## 优势
|
|
20
|
+
|
|
21
|
+
- 更全的本机环境，能力边界更大：继续使用你电脑里的仓库、依赖、命令行工具、登录态、SSH Key、内网和 VPN 环境，避免临时云环境缺依赖、缺权限、缺网络入口。
|
|
22
|
+
- 与 Codex CLI 的上下文管理完全一致：任务仍由本机 Codex CLI 执行，工作目录、会话状态和上下文管理方式保持原样，手机端只是远程交互入口。
|
|
23
|
+
- 扫码即用，微信里保留入口：启动后终端打印二维码，用微信扫描即可打开；把链接转发到自己的会话或文件传输助手，后续访问可以直接从微信打开。
|
|
24
|
+
- Token 机制降低误接入风险：NPX 启动默认生成一次性访问 token，前端页面、后端 API 和 WebSocket 都需要通过校验，降低 IP 或端口泄漏后被随意访问的风险。
|
|
25
|
+
|
|
26
|
+
## 快速开始
|
|
27
|
+
|
|
28
|
+
前置条件：
|
|
29
|
+
|
|
30
|
+
- Node.js 20 或更高版本
|
|
31
|
+
- 已安装并登录 Codex CLI
|
|
6
32
|
|
|
7
|
-
|
|
33
|
+
在要遥控的业务仓库根目录执行：
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
npx -y --registry=https://registry.npmmirror.com cli-link@latest
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
启动后：
|
|
40
|
+
|
|
41
|
+
1. 用微信扫描终端里的二维码。
|
|
42
|
+
2. 打开后把链接转发到自己的微信会话或文件传输助手，保留下次访问入口。
|
|
43
|
+
3. 后续只要电脑上的 AgentPilot 服务还在运行，就可以直接从微信里的链接打开。
|
|
8
44
|
|
|
9
|
-
|
|
45
|
+
如果你使用 npm 官方 registry，也可以运行：
|
|
10
46
|
|
|
11
|
-
|
|
47
|
+
```bash
|
|
48
|
+
npx -y cli-link@latest
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 典型场景
|
|
52
|
+
|
|
53
|
+
- 让 Codex CLI 在电脑上跑一个长任务，然后离开工位，用手机继续看进度。
|
|
54
|
+
- 在会议、通勤或外出时补充下一条指令，或中断当前任务。
|
|
12
55
|
- 远程批准或拒绝 CLI 的确认请求。
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
- 任务结束后从历史记录里复盘 Agent 做过什么。
|
|
56
|
+
- 在多个仓库之间切换工作目录，继续处理不同项目。
|
|
57
|
+
- 任务结束后从历史记录里复盘 Codex CLI 做过什么。
|
|
16
58
|
|
|
17
59
|
## 截图
|
|
18
60
|
|
|
@@ -34,22 +76,22 @@ AgentPilot 是一个移动端优先的 AI 编程 Agent 控制台。它把运行
|
|
|
34
76
|
- 暂存控制：支持对单个文件暂存/取消暂存，也支持全部暂存/全部取消，方便在手机上整理本次提交范围。
|
|
35
77
|
- 代码提交：暂存文件后可以打开提交面板，手动填写 Commit 信息，或让底层 CLI 基于已暂存变更和最近提交生成提交信息，再直接执行 `git commit`。
|
|
36
78
|
|
|
37
|
-
##
|
|
79
|
+
## 启动和配置
|
|
38
80
|
|
|
39
|
-
###
|
|
81
|
+
### NPX 启动
|
|
40
82
|
|
|
41
83
|
前置条件：
|
|
42
84
|
|
|
43
85
|
- Node.js 20 或更高版本
|
|
44
|
-
- 已安装并登录
|
|
86
|
+
- 已安装并登录 Codex CLI；如需使用 Claude Code CLI，也需要预先安装并登录
|
|
45
87
|
|
|
46
88
|
在要遥控的业务仓库根目录执行：
|
|
47
89
|
|
|
48
90
|
```bash
|
|
49
|
-
npx cli-link
|
|
91
|
+
npx -y --registry=https://registry.npmmirror.com cli-link@latest
|
|
50
92
|
```
|
|
51
93
|
|
|
52
|
-
|
|
94
|
+
如果你使用 npm 官方 registry，可以运行 `npx -y cli-link@latest`。后续示例为了简洁会省略 `-y`、`@latest` 和 `--registry`，实际使用时可以按需补上。
|
|
53
95
|
|
|
54
96
|
启动后终端会打印本机和手机访问地址：
|
|
55
97
|
|