Cairn / Docs / Board

Board Kanban

Every project has a Board tab — a drag-and-drop Kanban board with configurable columns, priorities, due dates, task dependencies, tags, and WIP limits. It's the same task data the AI chat, agent, calendar, and MCP tools work with, just laid out as cards.

Opening the board

Select a project and click Board in the top nav, or press ⌘3. New projects start with five default columns — Backlog, Todo, In Progress, Review, Done — created automatically.

Kanban board with cards across Backlog, Todo, In Progress, Review, and Done columns
The Board view — drag cards between columns to move work through your pipeline.

Creating a task

  1. Click + Add card at the top of any column
  2. Enter a title. Optionally add a description (markdown), priority, due date, and tags.
  3. Press Enter or click outside to save

Cards show a lightweight text preview when collapsed and render full markdown when expanded, so switching to the Board stays fast even on boards with long descriptions.

Priorities

Each card has a priority — low, medium, high, or urgent — shown as a coloured stripe on the card and used to size dots in the Insights analytics canvases. Medium renders blue, consistently across the board, card detail, and charts.

Columns & WIP limits

A board column at its WIP limit with an amber count badge and a disabled add-card button
A column at its WIP limit — the badge turns amber and the add-card button is disabled.

Card detail

Click any card to open its detail view — as a modal, or in a panel beside the AI chat when the chat is open (both share one implementation, so they stay in sync). From the detail view you can:

Task dependencies

A card can be marked as blocked by another card in the same project. A blocked card is visually flagged, and a blocker counts as resolved as soon as it moves to a done column or is archived. Circular dependencies are rejected automatically. Dependencies can be set from the card detail, from the AI chat, or via the MCP update_task tool (blockedBy / unblockFrom).

Find work that's ready

Ask the assistant for unblocked, active work and it uses list_ready_tasks — only cards with no pending blockers that aren't already in a done column. Great for "what can I start right now?"

Moving & filtering

Every move is undoable with ⌘Z / ⌘⇧Z.

Archive

Right-click a card and choose Archive to collapse it into a hidden section at the bottom of its column. Expand the section to review archived cards and restore any of them back to active. Archiving keeps a completed board tidy without deleting history; archived cards are excluded from the Calendar's overdue tracking and the "ready"/"due" task lists.

The board and the AI

The board isn't a separate silo — the AI chat, coding agent, and any MCP client read and write the same cards. The assistant can create cards, move them between columns, set priorities and due dates, add tags, link notes, and manage dependencies. See AI Chat and the MCP Server tool reference for the full set of task tools.