英語 |简体中文

コデックス・タスクボード

ローカルファーストの発行ボードで、ブラウザ上で動作し、スタンドアロンのCDPランチャーやその注入スクリプトを通じてCodexに埋め込むことができます。同じHTTP APIがReact UIと、バンドルされたCodex Skillで使われるtaskctlCLIを駆動します。

要件

• Node.js 22.5以降
• macOS アプリおよびDMGビルド:Xcode Command Line ToolsおよびRust 1.88以降、aarch64-apple-darwinおよびx86_64-apple-darwinターゲットを搭載。npm installは本プロジェクトで使用されているTauri CLIをインストールします。
• Windows NSISビルド:Microsoft Store Codex App、Rust 1.88以降、Visual Studio Build Tools(C++ワークロードおよびWindows SDK対応)。

ローカルで走れ

開いています。SQLiteデータベースは.data/taskboard.sqliteに保存されます。

ライブフロントエンドリロードを使った開発の場合:

ViteのUIはローカルサービスにAPIリクエストをプロキシし、動作します。

CLI を使います

プロジェクトから実行してください:

シェルパスにtaskctlを使いたい場合はnpm linkを使いましょう。CLIを別のローカルまたはLANサービスに向けるようにCODEX_TASKBOARD_URLを設定してください。クラウド展開は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