Local Agent Dashboard
把闲置的 Android 手机变成 AI 任务看板：不用一直盯着电脑，也能看到 Codex Desktop、Claude Code 和 DeepSeek Harness 的必要任务状态。
电脑上运行这个 npm 包，手机上安装配套 App。手机和电脑需要连接同一个局域网，也可以在 App 中添加多台电脑。
电脑需要什么？
brew install openssl@3
目前电脑端仅支持 macOS，暂不支持 Windows 和 Linux。
启动电脑端
在终端运行：
npx [email protected]
第一次运行时，npx 会询问是否下载，输入 y 确认即可。启动后会自动打开浏览器，显示这台电脑最近的任务。
使用期间请保持这个终端窗口打开。要停止服务，在终端按 Control + C。
连接 Android 手机
- 从 GitHub 下载 0.3.6 的 Android 安装包，在手机上安装。请选择
.apk文件；无需安装 Expo Go。 - 让手机和电脑连接同一个 Wi-Fi，或处于可以互相访问的局域网。
- 在电脑页面点击 连接手机，确认网络地址，再点击 应用所选地址。默认会选中所有可用地址，也可以用全选、反选来调整。
- 点击 生成配对邀请。打开手机 App，在 设置 → 电脑连接 中扫码；也可以把配对链接发送到手机，点击链接打开 App。
- 核对手机显示的电脑身份，并在电脑页面确认对应的连接申请。
连接成功后，手机就会显示这台电脑的任务。需要添加其他电脑时，在那些电脑上运行同一个命令，再从手机设置中添加。
手机端仅支持 Android arm64，系统要求 Android 8.0 或更新版本。目前 APK 使用测试签名，供试用。
常用命令
| 用途 | 命令 |
|---|---|
| 检查运行环境，排查启动问题 | npx [email protected] --doctor |
| 用示例任务体验界面 | npx [email protected] --demo |
| 启动时不自动打开浏览器 | npx [email protected] --no-open |
| 查看全部参数 | npx [email protected] --help |
如果下载的是 Release 中的 .tgz 文件，在文件所在目录运行：
npx --package ./local-agent-dashboard-0.3.6.tgz local-agent-dashboard
数据保存在哪里？
新安装的数据保存在当前用户目录：
~/Library/Application Support/Local Agent Dashboard
如果你已经使用过旧版，且没有创建过新目录，程序会继续使用原来的 ~/Library/Application Support/Agent Signal，保留已有电脑身份，不会自动移动或删除文件。启动前运行 --doctor，可以查看实际使用的目录。
也可以用 --state-dir <目录> 指定已有数据目录。同一个目录不要同时运行两个服务。通过源码启动时使用的 .runtime 目录不会自动迁移。
已批准手机的授权和已启用的网络地址保存在同一用户数据目录。服务重启或更新 npm 版本后会恢复；撤销授权也会保存。旧版本已经丢失的授权需重新配对一次，之后可保留。
隐私与使用范围
程序只读取本机 Codex、Claude Code 和 DeepSeek Harness 的任务状态，不安装 Hook，也不修改它们的配置。DeepSeek 默认读取 ~/.dsh/sessions，设置了 DSH_HOME 时读取该目录下的 sessions；支持标准 JSONL / Zstandard v0–v4 的状态子集，自定义持久化后端未接入。原生日志落盘可能延迟；没有明确事件时显示状态待确认，结束不等于已读。电脑管理页面只允许本机访问，手机连接使用加密通信，不经过云端中转。
任务标题可能包含私人信息，请只连接你信任的设备，不要公开分享配对链接或数据目录。任务状态识别仍在完善，部分会话可能显示为状态待确认。
项目目前未提供开源许可证，按 UNLICENSED 管理。源码、问题反馈和版本下载见 GitHub 仓库。