영어 | 简体中文

코덱스 태스크보드

브라우저에서 실행되는 로컬 우선 발행 게시판으로, 독립 실행형 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 이상 버전, 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