跳至主要内容

Codex Taskboard：嵌入 Codex 的议题面板

Fen9Pi2026/8/13AI 工程Codex大约 9 分钟

前言：议题管理的新范式

2026-08-13 08:37 GMT+8

管理议题的方式在进化：

第一代：纸质看板

  • 物理卡片
  • 白板或墙面
  • 面对面协作

第二代：SaaS 工具（Jira, Trello, Linear...）

  • 云端服务
  • 需要账户
  • 依赖网络
  • 数据在云端

第三代：本地优先 + AI 集成

本地优先的数据存储，嵌入 AI 工具，议题管理无缝集成

今天介绍 Codex Taskboard：

一个本地优先的议题面板，可在浏览器中运行，也可嵌入 Codex

一、项目概览

Codex Taskboard 是一个本地优先的议题管理工具，深度集成 Codex。

一句话说清楚：

本地优先的议题面板，嵌入 Codex，同一套 HTTP API 支持 React UI 和 CLI

项目地址：https://github.com/chuspeeism/dashi-taskboard 开源协议：未明确（开源仓库） 系统要求：Node.js 22.5+

核心特性

本地优先：

  • SQLite 数据库
  • 无需账户
  • 数据在本地
  • 快速响应

Codex 深度集成：

  • 嵌入 Codex 侧边栏
  • Skill 集成
  • CLI 工具
  • Git/worktree 支持

多种运行方式：

  • 浏览器中运行
  • 嵌入 Codex
  • 独立 macOS App

协作支持：

  • 局域网共享
  • Cloudflare 云端部署
  • 实时同步

二、核心功能

1. 本地运行

系统要求：

  • Node.js 22.5 或更高版本

快速开始：

npm install
npm run build
npm start

访问地址：

  • http://127.0.0.1:47823

数据存储：

  • SQLite 数据库存储在 .data/taskboard.sqlite

开发模式：

npm run dev

Vite UI 运行在 http://127.0.0.1:5173，并将 API 请求代理到本地服务。

2. CLI 操作

创建项目：

npm run taskctl -- project create \
  --id my-project \"
  --name "My project" \
  --workspace-path /absolute/path/to/repository

创建议题：

npm run taskctl -- issue create \
  --project my-project \
  --title "Implement the next slice" \
  --status todo \
  --priority high \
  --labels product,mvp

全局安装：

npm link

安装后可以在 shell 路径中直接使用 taskctl。

环境变量：

  • 设置 CODEX_TASKBOARD_URL 可让 CLI 指向另一个本地或局域网服务

3. Codex Skill 集成

安装 Skill：

ln -s /absolute/path/to/codex-taskboard/skills/manage-taskboard \
  ~/.codex/skills/manage-taskboard

Skill 功能：

该 Skill 会指导 Codex：

  1. 检查议题
  2. 将其移到 in_progress
  3. 使用乐观版本控制
  4. 验证工作
  5. 将其移到 in_review
  6. 只有在用户明确确认接受或要求将议题标记为完成后，才会将议题移到 done

工作流程：

议题检查 → in_progress → 工作执行 → 验证 → in_review → 用户确认 → done

三、嵌入 Codex

方式 1：手动 CDP 注入

启动专用 CDP 端口：

open -n -a /Applications/ChatGPT.app --args \
  --remote-debugging-port=9231 \
  --remote-allow-origins=http://127.0.0.1:9231

运行注入器：

CODEX_TASKBOARD_HOST=127.0.0.1 \
npm run codex:inject -- --port 9231 --open

效果：

  • 新 Codex 窗口显示 Taskboard 侧边栏入口
  • 原有 Codex 窗口不变

方式 2：一键启动独立窗口

推荐方式：

CODEX_TASKBOARD_HOST=127.0.0.1 npm run codex

该命令会：

  1. 启动本地 Taskboard 服务（如需要）
  2. 使用独立配置文件启动官方 macOS Codex App
  3. 等待主渲染器和侧边栏
  4. 在 Plugins 后注入原生外观的 Taskboard 入口
  5. 持续监视服务和替换后的渲染器

优势：

  • 一个命令完成所有操作
  • 现有 Codex 窗口不变
  • 新窗口显示 Taskboard 面板

方式 3：macOS App

无需终端即可打开和注入

开发模式：

npm run app:dev

构建 App 和 DMG：

rustup target add aarch64-apple-darwin x86_64-apple-darwin
npm run app:build

位置：

  • App：src-tauri/target/universal-apple-darwin/release/bundle/macos/Codex Taskboard.app
  • DMG：src-tauri/target/universal-apple-darwin/release/bundle/dmg/

功能：

  • 包含自己的 Node 运行时
  • 包含 Taskboard 服务
  • 包含构建后的 Web UI
  • 包含 Skill、CLI 包装器和注入脚本
  • 启动服务、启动 Codex App、注入侧边栏入口
  • 不显示终端窗口

数据存储：

  • ~/Library/Application Support/Codex Taskboard

日志：

  • ~/Library/Logs/Codex Taskboard/codex-taskboard-launcher.log

四、集成特性

深度 Codex 集成

注入方式：

  • 在 Codex 侧边栏添加 Taskboard 入口
  • 在 Codex 的整个主工作区渲染 iframe
  • 包括上下文标题栏区域

优势：

  • Taskboard 自己的页眉不会留下空白条
  • 完整的矩形页眉位于 Electron 可拖动层之上
  • 标记为 no-drag，Taskboard 活动时会隐藏原生上下文操作

"在对话中打开"：

  • 选择对应的原生 Codex 项目
  • 打开一个未发送的原生 composer
  • 包含 e-taskboard 指令和议题的真实标识符
  • 已安装的 Skill 会根据该指令隐式选中

会话归属关系：

  • 只有在会话实际处理该议题后，才会记录
  • taskctl 读取 Codex 的 CODEX_THREAD_ID
  • 在议题或评论变更上记录该 ID
  • 记录的 ID 可通过 Codex 的原生路由桥接点击

Git 集成：

  • 每个议题可以绑定一个 Git 分支或一个 worktree
  • 选项从所选 Codex 项目的仓库扫描
  • 不是手动输入

技术实现：

  • 使用 Codex 现有的项目、composer 和路由标记
  • 不会修改 React
  • 不会替换 fetch
  • 不会加载私有 chunk
  • 不会编辑 Codex 数据文件

五、协作支持

局域网共享

配置：

npm start

会输出：

  • 本地 URL
  • 可用的局域网 URL

协作者访问：

  • 同一受信任网络中的协作者可以打开其中一个局域网 URL
  • 使用同一个 Taskboard 服务

实时同步：

  • 任务、评论和附件变化通过服务器发送事件广播
  • 所有打开的客户端都会收到更新
  • 客户端重连后会执行完整刷新
  • 不会遗漏断开连接期间发生的变化

CLI 协作者：

CODEX_TASKBOARD_URL=http://<host-ip>:47823 taskctl issue list

安全性：

  • 局域网模式没有账户身份验证
  • 受信任本地网络中任何能访问该 URL 的人都可以读取和写入
  • 适合受信任的小团队

Cloudflare 云端部署

对于两名受信任的协作者：

架构：

  • Cloudflare Worker Static Assets
  • API 路由
  • D1 作为权威业务数据库
  • 私有 R2 bucket 存储附件

安全性：

  • 使用 HTTPS Basic 身份验证
  • 共享密码
  • 在全局修订号变化后刷新已打开的面板

本地 companion：

  • 每台设备保留自己的项目检出映射
  • 继续使用本地 companion 提供 Codex、Git/worktree、Skill 和 MCP 能力
  • 云端模式绝不会回退到本地 SQLite 数据库
  • 也不会同时写入本地数据库

详细文档： 参阅 云端协作

六、配置

环境变量

变量默认值用途
CODEX_TASKBOARD_HOST0.0.0.0HTTP 绑定地址；使用 127.0.0.1 可禁用局域网访问
CODEX_TASKBOARD_PORT47823本地 HTTP 端口
CODEX_TASKBOARD_DATA_DIR.dataSQLite 数据目录
CODEX_TASKBOARD_URLhttp://127.0.0.1:47823CLI API 源地址

使用场景

禁用局域网访问：

CODEX_TASKBOARD_HOST=127.0.0.1 npm start

指定数据目录：

CODEX_TASKBOARD_DATA_DIR=/custom/path npm start

CLI 指向远程服务：

CODEX_TASKBOARD_URL=http://192.168.1.100:47823 taskctl issue list

七、验证

运行检查：

npm run check

该命令会：

  • 运行 TypeScript 检查
  • 运行生产前端构建
  • 运行服务器/CLI/注入测试套件

八、技术架构

技术栈

后端：

  • Node.js 22.5+
  • Express（HTTP 服务器）
  • SQLite（本地数据库）
  • Server-Sent Events（实时同步）

前端：

  • React
  • Vite（构建工具）
  • TypeScript

桌面应用：

  • Tauri（macOS App）
  • Rust（系统级代码）
  • CDP（Chrome DevTools Protocol）

云端部署：

  • Cloudflare Workers
  • Cloudflare D1（数据库）
  • Cloudflare R2（存储）

核心设计

本地优先：

  • 数据存储在本地 SQLite
  • 无需账户
  • 快速响应
  • 离线可用

Codex 集成：

  • CDP 注入
  • Skill 集成
  • Git/worktree 支持
  • 乐观版本控制

多种运行方式：

  • 浏览器
  • 嵌入 Codex
  • 独立 App

协作支持：

  • 局域网共享
  • Cloudflare 云端
  • 实时同步

九、实际应用场景

场景 1：个人开发

需求：

  • 管理个人项目的议题
  • 与 Codex 深度集成
  • 本地优先，快速响应

使用方式：

npm start
# 打开 http://127.0.0.1:47823

优势：

  • 无需账户
  • 数据在本地
  • 快速响应

场景 2：小团队协作

需求：

  • 小团队（2-3 人）协作
  • 局域网共享
  • 实时同步

使用方式：

npm start
# 团队成员访问局域网 URL

优势：

  • 无需云端账户
  • 实时同步
  • 简单部署

场景 3：Codex 深度用户

需求：

  • 议题管理嵌入 Codex
  • Skill 集成
  • Git/worktree 支持

使用方式：

# 安装 Skill
ln -s /path/to/codex-taskboard/skills/manage-taskboard \
  ~/.codex/skills/manage-taskboard

# 启动嵌入版本
CODEX_TASKBOARD_HOST=127.0.0.1 npm run codex

优势：

  • 无缝集成
  • Skill 自动管理议题
  • Git/worktree 绑定

场景 4：远程协作

需求：

  • 受信任的两名协作者
  • 安全的云端部署
  • 本地 companion 提供能力

使用方式： 部署到 Cloudflare，使用 HTTPS Basic 身份验证

优势：

  • 安全
  • 实时同步
  • 本地能力保留

十、与传统工具的对比

vs Jira

维度JiraCodex Taskboard
部署云端 SaaS本地优先
账户必需无需（局域网）
数据云端本地 SQLite
AI 集成需要插件深度集成 Codex
Git需要配置自动扫描仓库
响应速度网络延迟本地速度

vs Trello

维度TrelloCodex Taskboard
部署云端 SaaS本地优先
账户必需无需（局域网）
数据云端本地 SQLite
AI 集成无深度集成 Codex
CLI无完整 CLI
嵌入无嵌入 Codex

vs Linear

维度LinearCodex Taskboard
部署云端 SaaS本地优先
账户必需无需（局域网）
数据云端本地 SQLite
AI 集成需要配置深度集成 Codex
嵌入无嵌入 Codex
本地 App无macOS App

十一、核心价值

1. 本地优先

数据在本地：

  • SQLite 数据库
  • 无需账户
  • 快速响应
  • 离线可用

2. Codex 深度集成

无缝集成：

  • 嵌入 Codex 侧边栏
  • Skill 集成
  • Git/worktree 支持
  • 乐观版本控制

3. 多种运行方式

灵活部署：

  • 浏览器
  • 嵌入 Codex
  • 独立 macOS App

4. 协作支持

灵活协作：

  • 局域网共享
  • Cloudflare 云端
  • 实时同步

5. 开发者友好

技术优势：

  • 完整 CLI
  • TypeScript
  • 现代技术栈
  • 易于扩展

十二、总结

核心问题

传统议题管理的痛点：

  • ❌ 云端 SaaS，需要账户
  • ❌ 数据在云端，不安全
  • ❌ AI 工具集成困难
  • ❌ 依赖网络，延迟高

Codex Taskboard 的解决方案

本地优先 + AI 集成：

  • ✅ 本地优先，数据在本地
  • ✅ 深度集成 Codex
  • ✅ 无需账户（局域网）
  • ✅ 快速响应
  • ✅ 灵活协作

为什么选择 Codex Taskboard？

1. 本地优先

  • 数据在本地
  • 无需账户
  • 快速响应

2. Codex 深度集成

  • 嵌入 Codex
  • Skill 集成
  • Git/worktree 支持

3. 多种运行方式

  • 浏览器
  • 嵌入 Codex
  • 独立 App

4. 灵活协作

  • 局域网共享
  • Cloudflare 云端
  • 实时同步

5. 开发者友好

  • 完整 CLI
  • 现代技术栈
  • 易于扩展

记住

Codex Taskboard 是议题管理的新范式。

本地优先的数据存储，嵌入 AI 工具，议题管理无缝集成。

一个本地优先的议题面板，深度集成 Codex。

附：资源链接

项目资源：

  • GitHub：https://github.com/chuspeeism/dashi-taskboard
  • Issues：https://github.com/chuspeeism/dashi-taskboard/issues
  • Releases：https://github.com/chuspeeism/dashi-taskboard/releases

文档资源：

安装速查：

# 本地运行
npm install
npm run build
npm start

# CLI 操作
npm run taskctl -- project create \
  --id my-project \
  --name "My project" \
  --workspace-path /absolute/path/to/repository

# 安装 Skill
ln -s /absolute/path/to/codex-taskboard/skills/manage-taskboard \
  ~/.codex/skills/manage-taskboard

# 嵌入 Codex
CODEX_TASKBOARD_HOST=127.0.0.1 npm run codex

# 构建 macOS App
rustup target add aarch64-apple-darwin x86_64-apple-darwin
npm run app:build

# 验证
npm run check
最近更新:
贡献者: Fen9Pi
Copyright © 2016-2022 风派 | 苏ICP备2025227748号-3