英文 |简体中文

Codex 任务板

一个本地优先的发布板，运行在浏览器中，可以通过独立的CDP启动器或其注入脚本嵌入Codex中。同一个HTTP API驱动React UI和捆绑Codex Skill使用的taskctl CLI。

要求

• Node.js 22.5或更新
• macOS 应用和 DMG 构建：Xcode 命令行工具和 Rust 1.88 或更新版本，目标为 aarch64-apple-darwin 和 x86_64-apple-darwin。npm install 安装了本项目使用的 Tauri CLI。
• Windows NSIS 构建：Microsoft Store Codex 应用、Rust 1.88 或更新版本，以及带有 C++ 工作负载和 Windows SDK 的 Visual Studio 构建工具。

本地跑步

打开。SQLite 数据库存储于 .data/taskboard.sqlite。

用于带实时前端加载的开发：

Vite UI运行于本地服务，并将API请求代理。

使用CLI工具

从项目中运行：

如果你希望 taskctl 在你的壳级路径上加 taskctl，请使用 npm link。设置 CODEX_TASKBOARD_URL 将 CLI 指向另一个本地或局域网服务。云部署通过 loopback companion（用于认证和路径映射的设备-本地环回服务——非聊天角色）配置，使用 taskctl cloud login。

English | 简体中文

Codex Taskboard

A local-first issue board that runs in a browser and can be embedded in Codex through the standalone CDP launcher or its injection script. The same HTTP API powers the React UI and the taskctl CLI used by the bundled Codex Skill.

Requirements

• Node.js 22.5 or newer
• macOS App and DMG builds: Xcode Command Line Tools and Rust 1.88 or newer with the aarch64-apple-darwin and x86_64-apple-darwin targets. npm install installs the Tauri CLI used by this project.
• Windows NSIS builds: the Microsoft Store Codex App, Rust 1.88 or newer, and Visual Studio Build Tools with the C++ workload and Windows SDK.

Run locally

npm install
npm run build
npm start

Open . The SQLite database is stored at .data/taskboard.sqlite.

For development with live frontend reload:

npm run dev

The Vite UI runs at and proxies API requests to the local service.

Use the CLI

Run it from the project:

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

Use npm link if you want taskctl on your shell path. Set CODEX_TASKBOARD_URL to point the CLI at another local or LAN service. Cloud deployments are configured through the loopback companion (device-local loopback service for auth and path mapping—not a chat persona) with taskctl cloud login.

Install the Codex Skill

Copy or symlink skills/manage-taskboard into the Codex skills directory, then start a new Codex task:

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

The desktop app keeps this same directory synchronized with its bundled Skill. The Skill teaches Codex to inspect an issue, move it to in_progress, use optimistic versions, verify the work, and then move it to in_review; it moves the issue to done only after the user explicitly confirms acceptance or asks to mark it complete.

Embed in Codex

Manual: use a dedicated CDP port

Keep the existing Codex window open. From the Taskboard repository, start a second Codex instance with a dedicated CDP port:

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

After the new Codex window appears, run the injector in another terminal:

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