TaskCenter（任务中心）

TaskCenter 是一个本地优先的 Agent 任务治理看板。Codex、Claude Code 等客户端通过本地 MCP 登记真实 Session、创建任务、更新进度并提交证据；TaskCenter 将“Agent 声称完成”和“人工验收通过”分开记录。

当前版本：v0.1.0，macOS-first。核心 Web 服务与 MCP 使用 Node.js，桌面快捷入口仅支持 macOS。

核心能力

• 按真实 Session 展示 Agent 创建的正式任务。
• 跟踪目标、计划、当前步骤、阻塞、预计时间、测试和证据。
• 通过 Hook 在写操作前检查 Session 是否已登记且存在活跃任务。
• 只读发现本机 Codex Session，用于来源筛选和状态展示。
• 所有任务账本和运行状态仅保存在本机。

隐私与安全边界

TaskCenter 只读访问：

• ~/.codex/sessions/**/*.jsonl
• ~/.codex/session_index.jsonl

TaskCenter 不读取 ~/.codex/auth.json、API Key、Cookie 或其他认证材料，不会修改 Codex 会话，也不会将聊天内容上传到远端。项目默认只监听本机地址，不支持未经重新设计的数据脱敏、多用户鉴权和远程部署。

快速开始

要求 Node.js >=22.13.0。

git clone https://github.com/<owner>/TaskCenter.git
cd TaskCenter
npm ci
npm run dev:live

打开 http://localhost:3000。dev:live 同时启动页面、Codex 会话监听器，以及只监听 127.0.0.1:3001 的本地控制服务。

macOS 可安装桌面快捷入口：

npm run desktop:install

配置 MCP 与 Hook

先输出基于当前克隆目录生成的配置：

npm run integrations:print

该命令只打印配置，不会改写 ~/.codex 或 ~/.claude。示例模板位于 integrations/。

Codex

注册本地 STDIO MCP：

codex mcp add taskcenter -- node "/absolute/path/to/TaskCenter/scripts/taskcenter-mcp.mjs"
codex mcp list

将生成的 Hook 配置合并到 ~/.codex/hooks.json，并确认 ~/.codex/config.toml 包含：

[features]
hooks = true

重新启动 Codex，在 /hooks 中审核并信任 Hook，在 /mcp 中确认 taskcenter 已连接。也可以把 MCP 配置放进可信项目的 .codex/config.toml。

Claude Code

注册用户级 MCP：

claude mcp add --scope user --transport stdio taskcenter -- \
  node "/absolute/path/to/TaskCenter/scripts/taskcenter-mcp.mjs"
claude mcp list

将生成的 Hook 配置合并到 ~/.claude/settings.json。如需项目共享 MCP，可将 integrations/claude/mcp.json.example 复制为目标项目的 .mcp.json，替换路径后由使用者审核授权。

配置变更只对新启动或重新加载的 Session 生效。Hook 依赖本机控制服务，因此使用 Agent 前应保持 npm run dev:live 正在运行。

Agent 任务协议

每个 Session 按以下顺序执行：

1. taskcenter_session_register：提交真实 session_id、workspace、agent、provider 和 model。
2. taskcenter_task_create：提交目标、计划和验收标准。
3. 收到 accepted=true 与独立 task_id 后才能执行写操作。
4. 使用 taskcenter_task_update 更新进度，使用 taskcenter_task_report 上报结果。
5. Agent 的 done_claimed 只表示实现声明，不能自动升级为人工验收通过。

MCP 工具：

• taskcenter_session_register
• taskcenter_session_status
• taskcenter_task_create
• taskcenter_task_query
• taskcenter_task_update
• taskcenter_task_report

数据文件

运行态写入 data/，并由 .gitignore 排除。仓库只保留空白 seed、示例数据和空的 Session 合并配置。删除运行态前请确认范围；TaskCenter 不应删除或改写 ~/.codex 下的会话与认证数据。

开发与验证

npm run sync
npm run lint
npm test
git diff --check
npm audit --omit=dev
npm pack --dry-run

npm test 会执行同步、生产构建和 tests/*.test.mjs。Chrome 长期稳定性和真实 Hook 生命周期仍需要本机持续运行验证。

许可证

Apache License 2.0。参见 LICENSE。