Workspace

The kanban board

A Markdown file with layout: board opens as a board. Every change is written back as plain Markdown text that can be diffed and committed.

Animation of kanban cards moving between the Plan, In Progress, Review, and Done lists — Cards move from Plan to In Progress and then to Review

File format

---
layout: board
---

## Plan

- [ ] Write the report #important [due:: 2026-10-20]
  card notes (indented lines)
- [ ] Send the invitations

## Done

- [x] Book the venue

A ## heading becomes a list, a - [ ] item becomes a card, and [x] means done.
The indented lines below a card are its notes.
#tag is shown as a colored label; [due:: 2026-10-20] as a due date, red when it is overdue.
Anything that is not recognized is preserved as it is.

Creating a board

The ☰ menu → New Kanban Board creates an empty board that has no name yet.
Right-click in the file tree → New Kanban Board… creates it right away as a file in that folder, with the lists Plan, In Progress, and Done.
Ctrl+Shift+B switches between the board view and the text.

Working with cards

Drag a card between lists or to another position in the same list; near the edge, the board scrolls automatically.
Click a card to edit its title, notes, due date, and Assigned to.
The due date can be typed (with a time if you like, e.g. 2026-10-20 09:00) or chosen with the calendar button, with Today and Clear. Choosing a date keeps the time that was already typed.

The card edit dialog with the title, tags, due date with a calendar button, assigned to, and notes fields — The card edit dialog: a due date with a calendar button and the Assigned to field

Right-click to move, move up/down, and delete; check the box to mark it done.
[[Note]] in a card title is shown as a link that can be clicked. A link in the notes of a card is shown as a ↗ name row below the chip. The notes field in the card dialog suggests names when you type [[.
Undo and redo apply to changes on the board.

The board and the agent

The Markwork agent changes the board through edit_kanban: adding, moving, marking, editing, or deleting cards and lists, always through the review window.
A card marked @pi is worked on by the pi harness in another project folder. See The pi orchestrator. The contents of the notes linked with [[ ]] on a card are included in the pi prompt as context.