Dashboard
The dashboard is a web UI served by the same process as the CLI API. No separate server, no separate install.
Access it at:
http://localhost:41920What it shows
Kanban board
The main view is a kanban board with four columns:
| Column | Status | Color |
|---|---|---|
| Open | open | Blue |
| In Progress | in-progress | Amber |
| Review | review | Purple |
| Done | done | Green (collapsed by default) |
The Backlog section (backlog status) sits above the kanban, collapsed by default. Click to expand.
The Blocked section is a horizontal red band below the column headers. All blocked tasks appear here regardless of their previous status. Blocked tasks are the most actionable items — they’re surfaced prominently so they don’t get buried.
Task cards
Each card shows:
- Task title
- Priority badge (P0 in red, P1 in amber, P2 in gray)
- Assignee name (if claimed)
- Task ID
Click any card to open the task detail panel. The detail panel shows all task fields: description, verify command, acceptance criteria, dependencies, notes, artifacts, and timestamps.
Agent panel
The collapsible sidebar (left side) shows agents that have interacted with the project. Click the hamburger icon to expand. Working agents show their current task. Agents are auto-populated — no registration needed.
Creating tasks
Click the ”+ Add Task” button in the top bar to open the task creation form. Fill in title, priority, and optional fields. The task appears on the board immediately. You can also drag and drop task cards between columns to change their status.
Real-time updates
The dashboard polls the server every 30 seconds. You do not need to refresh the page. Changes made via the CLI appear within 30 seconds. Actions taken in the dashboard (adding tasks, drag-and-drop) refresh immediately.
There is no WebSocket connection — the polling interval is sufficient for typical agent workflows where tasks take minutes to hours, not milliseconds.
Design
The dashboard uses the same design system as the codepakt documentation site. Dark mode is the default. A theme toggle in the header switches to light mode.
Status colors:
| Status | Color |
|---|---|
| open | Blue |
| in-progress | Amber |
| review | Purple |
| blocked | Red |
| done | Green |
| backlog | Gray |
Port and access
The dashboard is served at the root path (/) of the same port as the API (/api/*). If you changed the default port:
open http://localhost:8080To access from another machine on the same network:
open http://192.168.1.10:41920The dashboard has no authentication in v0.1. It’s designed for local or trusted-network use. If exposing to a wider network, put it behind a reverse proxy with HTTP basic auth.
Related
- cpk board status — same board data in the terminal
- Architecture — how the server serves both API and dashboard