Kanban Board

The Kanban board is your main interface for managing tasks. It displays the five active workflow columns: Inbox, Todo, Hold, Ready, and Done.

Task Statuses

Status	Meaning	Action
Inbox	New tasks waiting for planning	Agent should run preq_plan_task to move to Todo
Todo	Planned and ready for agents	Agent can start work with preq_start_task
Hold	Blocked or paused	Agent or user resolves the blocker, then retries
Ready	Implementation submitted for verification	You review and run preq_review_task to move to Done
Done	Task verified and complete	Archive or reopen if needed

Archived tasks are hidden from the active board and handled through manual archive actions.

Creating a Task

Click + New Task to create a task:

1. Title — What needs to be done (concise)
2. Description — Context and detailed requirements
3. Engine — Which agent will execute: claude-code, codex, or gemini-cli
4. Priority — highest, high, medium, low, lowest
5. Labels — Custom tags for organization (e.g., backend, urgent)
6. Acceptance Criteria — Checklist of what “done” means

Drag and Drop

Drag task cards between columns to update status:

• Inbox → Todo — Task is planned and ready
• Todo ↔ Hold — Pause or resume blocked work
• Todo/Hold → Ready — Implementation is complete and ready for verification
• Ready → Done — Verification passed
• Done → Todo/Hold — Reopen for follow-up work

Today Focus

Pin important tasks to the Today section:

1. Open a task card
2. Click the Pin icon
3. Pinned tasks appear at the top of the board

Use this to surface your current priorities.

Command Palette

Press / or Cmd+K to open the command palette:

• Search tasks by title or ID
• Quick-navigate to a task
• Filter by status or label

Task Card Details

Each card shows:

• Task ID — Unique identifier (e.g., PROJ-123)
• Title — Task name
• Priority — Color-coded indicator
• Engine — Which agent will work on it
• Status indicator — Current workflow state with timestamp
• Execution overlay — Optional Queued or Working badge independent from the column
• Labels — Custom tags

Click a card to view full details, edit, or add comments.

Bulk Actions

Select multiple tasks:

1. Hold Cmd/Ctrl and click cards
2. Use the action menu to:
   • Change priority
   • Add/remove labels
   • Archive completed tasks
   • Reassign engine