Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (claudeboard) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ClaudeBoard 🤖

Autonomous coding dashboard for Claude Code.
Turn a PRD into tasks → let Claude work autonomously → watch progress in real time.

How it works

claudeboard init          → Configure project + Supabase
claudeboard import-prd    → Parse PRD → create tasks automatically
claudeboard start         → Launch dashboard on localhost
                          → Give Claude Code the AGENT.md file
                          → Claude works autonomously 24/7

Install

npm install -g claudeboard

Setup (one time per project)

1. Init

cd your-project
claudeboard init

You'll be asked for:

Project name
Supabase URL
Supabase anon key
Port (default 3131)

2. Run SQL in Supabase

Open claudeboard-setup.sql and run it in your Supabase SQL Editor.
This creates the tables cb_epics, cb_tasks, cb_logs with Realtime enabled.

3. Import your PRD

claudeboard import-prd ./PRD.md

Claude parses your PRD and creates structured tasks grouped by epic automatically.

4. Start the dashboard

claudeboard start

Opens http://localhost:3131 in your browser.

Running Claude Code autonomously

claude --context AGENT.md

The AGENT.md file (auto-generated by claudeboard init) tells Claude to:

Fetch the next pending task from the API
Start it → mark as in_progress
Do the work (write code, run tests, fix errors)
Log progress in real time
Mark as done or error
Repeat until all tasks are complete

Dashboard features

Kanban view — tasks grouped by epic with status colors
Live activity log — every action Claude takes
Progress bar — overall completion %
Add tasks — add new tasks manually (Claude picks them up automatically)
Task detail — click any task to see its full log
Real-time — WebSocket updates, no refresh needed

API (used by Claude Code)

Method	Endpoint	Description
GET	`/api/board`	Full board state
GET	`/api/tasks/next`	Next pending task
POST	`/api/tasks/:id/start`	Mark task as in_progress
POST	`/api/tasks/:id/log`	Add a log entry
POST	`/api/tasks/:id/complete`	Mark task as done
POST	`/api/tasks/:id/fail`	Mark task as error
POST	`/api/tasks`	Add a new task
GET	`/api/tasks/:id/logs`	Get logs for a task

Remote access

To monitor from another computer:

# On the notebook running claudeboard:
# Install Tailscale: https://tailscale.com
tailscale up

# Then from your main computer:
# Visit http://<notebook-tailscale-ip>:3131

Or with SSH tunnel:

ssh -L 3131:localhost:3131 user@notebook-ip
# Then open http://localhost:3131 locally

Stack

CLI: Node.js + Commander + Enquirer
Server: Express + WebSockets
Database: Supabase (Postgres + Realtime)
Dashboard: Vanilla HTML/CSS/JS (no build step)
AI parsing: Claude claude-sonnet-4-20250514 for PRD analysis