Docs Features

cpk board

cpk board status gives you a snapshot of the entire board in one call. It’s the fastest way to answer “what’s happening right now.”

cpk board status

cpk board status
Project: my-app

Tasks by status:
  backlog:     3
  open:        4
  in-progress: 2
  review:      1
  blocked:     1
  done:        12

Blocked tasks:
  T-008  "Set up staging environment"
         Reason: Waiting for AWS credentials from ops team

Agents:
  backend   working  T-003 (Build auth API endpoints, P0)
  frontend  working  T-007 (Build login UI, P1)
  infra     idle

The output has three sections:

Tasks by status — counts across all six states. A healthy board has tasks moving through openin-progressdone. Watch for accumulation in blocked or review.

Blocked tasks — every task in blocked status, with the reason. Blocked tasks are the most actionable signal — they represent work that’s stopped and needs human intervention or dependency resolution.

Agents — agents that have interacted with the project, their current status, and what they’re working on.

Reading the board

A few patterns to watch for:

Blocked accumulation — if blocked tasks are growing, something systemic is wrong. Check blocker reasons. Often it’s a missing dependency, an external dependency (credentials, access), or a task that needs to be broken down.

Review accumulation — tasks sitting in review without moving to done means no one is doing review. Either add a reviewing agent or automate the review step with a --verify command.

All agents idle, tasks open — no agent has called cpk task pickup recently. Check if agents are running.

No open tasks, all agents idle — either the work is done (check done count) or all remaining tasks are in backlog with unmet dependencies.