chuspeeism/dashi-taskboard

Purpose and entry points

Codex Taskboard is a local-first task/project board usable in a browser, through a macOS launcher that embeds it into Codex/ChatGPT, and through automation clients. Primary entry points are the Node HTTP service (server/index.mjs), React client (web/src/main.tsx), CLI (cli/taskctl.mjs), and Tauri launcher (src-tauri/src/main.rs).

Local service and persistence

The Node service owns the HTTP API, SQLite-backed task data, attachments, and real-time synchronization. It serves the built web client, writes local data under the configured data directory, and uses server-sent events to notify connected boards; reconnecting clients perform a full refresh.

• server/app.mjs

• server/database.mjs

• server/index.mjs

Domain and workflow model

Shared modules define taskboard domain concepts plus workflow sequencing/control-flow semantics used across service, UI, CLI, and automation. Project automation policies bridge task state changes to Codex-oriented execution behavior.

• shared/domain.mjs

• shared/workflow-control-flow.mjs

• shared/taskboard-automation.mjs

React taskboard client

The Vite/React application consumes the local API and presents dashboard, board, Gantt/list, issue detail/editor, relations, comments, attachments, and project automation configuration. Client state includes storage-backed preferences, API access, revision polling, and AI-chat state.

• web/src/App.tsx

• web/src/api.ts

• web/src/components/TaskDetail.tsx

AI chat subsystem

The server exposes AI-chat endpoints and coordinates process execution, turn ownership, cataloging, and persisted chat/task state. The web UI renders the corresponding conversation experience, keeping this integration behind the HTTP API rather than directly invoking local Codex capabilities.

• server/ai-chat.mjs

• server/ai-chat-process.mjs

• web/src/components/AiChat.tsx

Codex/ChatGPT embedding and automation

Injection tooling launches or attaches to a Chromium DevTools Protocol-enabled official client, bypasses renderer CSP as needed, and inserts the taskboard entry/iframe without modifying the vendor application. Shared executable/environment discovery and the supervisor support long-running injected sessions and recovery.

• scripts/codex-injector.mjs

• scripts/taskboard-supervisor.mjs

• inject/codex-taskboard.user.js

macOS distribution runtime

A Tauri Rust launcher packages Node, server, web assets, CLI, injector, and skill into a universal macOS app. It starts a loopback service on a random port, starts a separate official-client window with a random CDP port, injects the board, supervises failures, and uses Tauri’s signed updater. GitHub Actions builds, signs, notarizes, verifies, and promotes immutable releases.

• src-tauri/src/main.rs

• src-tauri/tauri.conf.json

• .github/workflows/release-macos.yml

Optional cloud collaboration

Cloud deployment is a Cloudflare Worker-based shared backend using D1 migrations, static assets, and private R2 attachments. Local devices retain project checkout mappings and companion capabilities; cloud proxy/config code separates this optional synchronized mode from the local database runtime.

• cloud/src/index.mjs

• cloud/migrations/0001_initial.sql

• server/cloud-proxy.mjs