Board & views

Running kandown opens the web board at http://localhost:5176 (the port is configurable). It is served by a local daemon as a single self-contained HTML file.

Two views

Board

The default: a horizontal kanban with drag-and-drop between columns. Columns are freely editable — rename them, reorder them, add or remove them in Settings, and every task's status follows.

The last column is the terminal column. Moving a task there is what triggers the dependency gate described in Tasks.

List

A sectioned list with filters and sorting, better suited to a large backlog than a wide board. Switch with ⌘1 and ⌘2.

Finding things

Search (/) is full-text across titles, bodies, subtasks, tags, assignee and priority — not just titles.

Filters narrow by status, tag, assignee, priority and owner type. Owner filtering is the one worth remembering on a shared board: it separates your work from your agents' at a glance.

Group by reorganises either view by priority, assignee or epic.

Command palette (⌘K) is the fastest way to reach any of the above, plus task creation and navigation.

Editing a task

Opening a task gives you a WYSIWYG Markdown editor for the body, with structured controls for the fields alongside it. The report field is rendered prominently — on a board that agents write to, the completion report is usually the thing you actually want to read.

Due dates

Tasks with a due date surface in a banner when they come due or run late, so a date you set three weeks ago does not quietly pass.

Bulk operations

A whole column can be archived or deleted in one action, which is how you clear a Done column at the end of a cycle without touching twenty files.

Keyboard shortcuts

The daemon

The board is served by a per-project daemon that outlives the terminal UI, so closing your shell does not close your browser tab.

kandown daemon status
kandown daemon start
kandown daemon stop
kandown projects        # every open kandown project on this machine

It binds to 127.0.0.1 only and mints a random per-project API token at startup — see Configuration § security.