https://github.com/forxidian/agent-mission-control
Local mission-control dashboard for Codex, OpenCode, Claude Code, and compatible agent sessions.
https://github.com/forxidian/agent-mission-control
agent-dashboard ai-agents claude-code codex dashboard developer-tools local-first opencode productivity
Last synced: 20 days ago
JSON representation
Local mission-control dashboard for Codex, OpenCode, Claude Code, and compatible agent sessions.
- Host: GitHub
- URL: https://github.com/forxidian/agent-mission-control
- Owner: forxidian
- License: mit
- Created: 2026-05-09T07:36:08.000Z (24 days ago)
- Default Branch: main
- Last Pushed: 2026-05-09T08:10:58.000Z (24 days ago)
- Last Synced: 2026-05-09T10:22:18.600Z (24 days ago)
- Topics: agent-dashboard, ai-agents, claude-code, codex, dashboard, developer-tools, local-first, opencode, productivity
- Language: JavaScript
- Size: 301 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Agent Mission Control
本地多 Agent 任务控制台，用来集中查看 Codex、OpenCode、Claude Code / Claude Desktop 等工具里的线程、项目、token 用量、运行状态和待处理事项。
它默认只监听 `127.0.0.1`，只读取本机状态文件，不写入 Codex / OpenCode / Claude 的工作数据，也不发送遥测。
## 功能截图
截图由 `npm run screenshot:mock` 通过虚构数据生成，只展示界面形态，不包含本机线程、路径、消息、token 或 quota 细节。
## 最近更新
- 自动刷新默认 30 秒，可切到 10 秒或 60 秒；后台页面暂停拉取，窗口失焦自动降频到 60 秒，服务端用 dashboard / 通知快照和性能指标降低持续读盘与 JSON 解析压力。
- 支持安装为 Chrome / Edge PWA 独立窗口，并能从浏览器页或 macOS 菜单栏辅助工具优先切回已安装应用。
- quota 总览支持按 GPT、Claude 等模型家族分组，Claude Desktop / Cowork 可从本地 Claude usage cache 读取聚合限额信号。
- Claude Desktop Code 支持 `claude://resume` deep link 恢复会话，Claude Cowork 未完成任务会作为运行中信号展示。
- 顶部 Host 工作中 / 待处理指标现在可点击跳转到对应面板，通知操作采用乐观更新，窄屏线程操作更紧凑。
完整版本记录见 [CHANGELOG.md](CHANGELOG.md)。
## 功能
- 汇总 Codex 本地线程、标题、项目、归档状态、模型、token 和 quota 信息。
- 汇总 OpenCode CLI / Desktop 会话，并识别待授权工具调用和 todo。
- 汇总 Claude Code CLI、Claude Desktop Code、Claude Cowork 会话。
- 按 GPT、Claude 等模型家族展示实时和本周 quota 可用量。
- 支持按来源、状态、项目和关键词筛选。
- 支持打开 Codex / OpenCode / Claude Desktop Code deep link，或在 macOS Terminal 恢复 CLI 会话。
- 支持安装为本地 PWA 应用窗口；service worker 只缓存静态前端壳，不缓存 `/api/*` 本机 Agent 元数据。
- 提供本地通知中心；系统桌面提醒当前隐藏，待后续接入可靠的原生通知实现。
## 要求
- Node.js `>=20`
- macOS 推荐；Linux / Windows 可运行看板，但部分打开应用和桌面通知能力取决于系统命令
- 可选：`sqlite3` 命令，用于读取 Codex 本地 SQLite 状态
- 可选：`codex`、`opencode`、`claude` CLI，用于检测版本或恢复 CLI 会话
## 运行
```bash
git clone https://github.com/forxidian/agent-mission-control.git
cd agent-mission-control
npm start
```
打开：
```text
http://127.0.0.1:4629
```
安装成网页应用：
- 在 Chrome / Edge 打开本地地址后，点击顶部的“安装应用”按钮，或使用地址栏里的安装入口。
- 安装后会像普通桌面应用一样以独立窗口打开；再次从浏览器页点击顶部按钮会优先通过本地服务打开 macOS 上的 Chrome/Edge PWA app shim。
- 如果本地 app shim 不可用，会再尝试 `web+agentmissioncontrol:` 协议唤起；卸载可从浏览器应用菜单完成。
- 独立 PWA 窗口内提供“收起”按钮，可把窗口最小化到 Dock；macOS 红色关闭按钮仍由 Chrome app shim 管理，网页不能把它改成最小化。
- PWA 只缓存前端壳子和图标，不缓存 `/api/*` 返回的本机 Agent 元数据。
可选环境变量：
```bash
PORT=4629 HOST=127.0.0.1 npm start
```
不要把 `HOST` 绑定到公网或不可信局域网地址，除非你已经评估过本机 Agent 元数据暴露风险。
## 数据来源
Codex：
- `~/.codex/state_5.sqlite`
- `~/.codex/session_index.jsonl`
- `~/.codex/sessions/**/rollout-*.jsonl`
OpenCode：
- `opencode session list --max-count 120 --format json`
- `~/Library/Application Support/ai.opencode.desktop/opencode.global.dat`
- OpenCode Desktop workspace state/cache 文件
Claude：
- `~/.claude/projects/**/*.jsonl`
- `~/Library/Application Support/Claude/claude-code-sessions/**/*.json`
- `~/Library/Application Support/Claude/local-agent-mode-sessions/**/*.json`
- 同目录下的 `audit.jsonl` 和 `spaces.json`
本项目自己的通知状态：
- `~/.agent-mission-control/notifications.json`
## 隐私
这个项目用于本地查看你的 Agent 工作状态。它可能在浏览器里展示线程标题、项目路径、最近消息信号、token 与 quota 信息。详见 [docs/PRIVACY.md](docs/PRIVACY.md)。
请不要提交本机状态文件、日志、数据库、`.env`、截图里的私密文本、cookie、token 或 API key。
## 开发
```bash
npm test
```
项目刻意保持轻依赖：当前没有外部 npm 依赖，主要使用 Node.js 内置 test runner、浏览器原生 API 和系统命令。
版本变化见 [CHANGELOG.md](CHANGELOG.md)。
生成 README 演示图：
```bash
npm run screenshot:mock
```
这个命令会启动真实前端和 mock API，并用 Chrome headless 截图。
如果 Chrome 不在默认 macOS 路径，可以通过 `CHROME_PATH` 指定浏览器可执行文件；如果端口被占用，可以通过 `PORT` 指定临时端口。
## 开源准备
这份仓库已按开源发布做过基础脱敏整理。发布前复核清单见 [docs/OPEN_SOURCE_PLAN.md](docs/OPEN_SOURCE_PLAN.md)。