Argus

Argus 是一个本地运行的 Codex 任务监控与数据桥接工具。它把分散在 Codex 本机服务、会话记录和生命周期事件中的信息整理成统一视图，让你可以：

• 查看所有未归档的 Codex 任务；
• 识别任务正在运行、等待确认、已经完成还是发生错误；
• 查看当前 reasoning、Tool、MCP、writing 等活动阶段；
• 查看 Codex 官方返回的额度窗口、剩余额度和刷新时间；
• 从网页面板打开对应的 Codex 任务；
• 通过 HTTP、SSE 或 Node.js Client 把数据接入自己的桌面组件、宠物或硬件。

当前版本只支持 Codex。Argus 不执行任务，也不会读取或对外公开 Tool 参数、命令输出、环境变量或凭据。

快速体验

需要 Node.js 20 或更高版本。从 npm 全局安装：

npm install --global argus-runtime
argus serve --demo-data

同一个本地服务会提供：

• 使用文档：http://127.0.0.1:8765/docs/
• Demo：http://127.0.0.1:8765/demo

这个模式只模拟任务状态，适合先了解界面；它不会生成虚假额度。

连接真实 Codex

先确认 Codex Desktop 或 Codex CLI 已经启动，并且本机 shared daemon socket 存在：

test -S "$HOME/.codex/app-server-control/app-server-control.sock" && echo "Codex socket ready"

再启动 Argus：

CODEX_APP_SERVER_SOCKET="$HOME/.codex/app-server-control/app-server-control.sock" \
argus serve

发布包已经内置使用文档；argus serve 会同时提供 /docs/、/demo 和 /v1。保持终端运行并打开文档或 Demo；status、tasks、usage 和 Hooks 都不是打开网页前必须执行的步骤。

可选：接入 Codex Hooks

Hooks 可以补充任务的生命周期信息，但不是启动 Argus 的必要条件。确保 argus 已在 PATH 后执行：

argus init

该命令会安全合并 ~/.codex/hooks.json，保留文件中的其他配置。之后仍需在 Codex CLI 中运行 /hooks，审查并信任新增或修改的 Argus Hook。

文档

• 认识 Argus
• 安装
• 快速开始
• 可视化界面
• CLI
• Codex Hooks
• 状态与数据可信度
• API
• 故障排查
• 参与贡献

普通使用者不需要另外启动文档服务。argus serve 已经同时提供 /docs/ 与 /demo。

只有编写文档并需要热更新时，才单独启动文档开发服务器：

npm install --prefix docs-site
npm run docs:dev

打开 http://127.0.0.1:3000。这个 3000 端口仅用于文档开发。

隐私与网络边界

• Bridge 默认只监听 127.0.0.1:8765；
• Hook 只保存事件名、session/turn id、Tool 名和 tool-use id；
• 本地降级数据会明确标注来源和时效，不会冒充实时结果；
• 当前服务没有为公网访问设计身份认证，不建议直接暴露到局域网或公网。

开发检查

npm run check
npm run docs:build

Argus 使用 MIT License。