Английский | 简体中文

Taskboard Codex

Плата с локальным приоритетом, которая работает в браузере и может быть встроена в Codex через отдельный лаунчер CDP или его скрипт инъекции. Тот же HTTP-API питает интерфейс React и CLI taskctl, используемый в комплекте Codex Skill.

Требования

• Node.js версии 22.5 или новее
• сборки приложений и DMG для macOS: Xcode Command Line Tools и Rust 1.88 или новее с целями aarch64-apple-darwin и x86_64-apple-darwin. npm install устанавливает Tauri CLI, используемый в этом проекте.
• Сборки для Windows NSIS: приложение Microsoft Store Codex, Rust 1.88 или новее, а также Visual Studio Build Tools с рабочей нагрузкой на C++ и Windows SDK.

Беги локально

Открыть . База данных SQLite хранится по адресу .data/taskboard.sqlite.

Для разработки с живой перезагрузкой фронтенда:

Интерфейс Vite работает на и прокси API в локальный сервис.

Используйте CLI

Запустите его из проекта:

Используйте npm link, если хотите taskctl на пути оболочки. Установите CODEX_TASKBOARD_URL так, чтобы CLI указывал на другой локальный или локальный сервис. Облачные развертывания настраиваются через loopback companion (device-local loopback service для аутентификации и картирования путей — не чат-персону) с помощью 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