# Board & views

The web interface — kanban and list views, filtering, search, the command palette and keyboard shortcuts.

> Kandown documentation — https://kandown.dev/docs/guides/board-and-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](/docs/guides/tasks.md#dependencies).

### List

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

## Finding things

**Search** (<kbd>/</kbd>) 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** (<kbd>⌘</kbd><kbd>K</kbd>) 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

| Keys | Action |
|---|---|
| <kbd>⌘</kbd><kbd>K</kbd> | Command palette |
| <kbd>⌘</kbd><kbd>1</kbd> / <kbd>⌘</kbd><kbd>2</kbd> | Board view / list view |
| <kbd>N</kbd> | New task |
| <kbd>/</kbd> | Search |
| <kbd>R</kbd> | Reload from disk |
| <kbd>⌘</kbd><kbd>S</kbd> | Save |
| <kbd>⌘</kbd><kbd>⌫</kbd> | Delete |
| <kbd>Esc</kbd> | Close the current panel |

## 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.

```bash
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](/docs/reference/configuration.md#security).
