All pages

Lesson 3.3 · Organize your work · 12 min

The Kanban board

Track work as cards the agent can read, claim and move.

Listen

After this lesson you can track a project's work as cards on its own board, manage them from the keyboard, and hand cards to the agent by number.

Time: 12 minutes · Works on: macOS app. Linux and Windows have a smaller Tasks page, and the cloud workspace has boards of its own.

Open the board

  1. Show the right sidebar with ⌘⇧\.
  2. Open the More ▾ menu and choose Tasks.

Every project has its own board. A new board starts with three columns: To Do, In Progress and Done. The header shows how many cards are open and how many are overdue. When cards are late, the More ▾ menu says so too ("Tasks — 2 late"), so you notice even with the tab closed.

Add and move cards

  1. Click + at the top of To Do. A New task… field opens.
  2. Type "Write the release notes" and press Return.
  3. Add two more cards the same way.
  4. Drag a card into In Progress. Or right-click it and use Move Forward, Move Back or Move To.

Each card gets a number, shown as #1, #2 and so on. That number is how you and your agents refer to it.

Work from the keyboard

Click a card to select it, then:

Key Does
Up and down arrows Select another card
Right and left arrows Move the selected card to the next or previous column
Space Unfold the card's notes, checklist and links in place
Return Open the full editor
n New task
e Archive the selected card
/ Jump to the filter field
Delete Delete the selected card
Esc Clear the selection and any filters

Fill in a card

Double-click a card, or press Return, to open the editor. A card can hold:

  • Priority and a Due Date. Overdue cards drive the "late" counts.
  • Labels, comma-separated, for filtering.
  • Notes in Markdown, with Write and Preview.
  • A Checklist of steps. Type into Add a step… and click Add. The card row shows progress like 2/7, and you can tick steps without opening the editor by unfolding the card with Space.
  • Blocked By: other cards that must be finished first.
  • Links to anything you want to open from the card.
  • Activity: the card's history, written for you.

Click Save when you're done.

Shape the board

Use the menu on a column header for Add Column…, Rename… and WIP Limit…. A column over its work-in-progress limit shows it.

The board menu in the header has more:

  • Undo and Redo for any board change. ⌘Z works too.
  • Archive Finished Work and the Archive… list.
  • All Projects…, a roll-up of every board in every project.
  • Boards, to make New Board…, Rename Board… or Delete Board.

Most projects need one board. Add a second when a project has separate streams of work, such as bugs beside features. Each board has its own columns, numbering and undo history. When there is more than one, click the board name in the header to switch. Deleting a board asks first and can't be undone. The project's main board can't be deleted; Reset Board empties it instead.

Hand cards to the agent

The agent reads and writes the same board. In the Agent tab, try:

  • "What's on the board?"
  • "Add a card to write tests for the login form, due Friday."
  • "Move #2 to Done."
  • "What's left on #1?"

Without a board name, the agent works on the board you have selected, so cards land where you're looking. Every reply names the board it used.

Claude Code connected to TRMNLY over MCP gets the same tools. You can ask it to "log everything you fixed as cards" and watch them appear.

Claims

When an agent works a card, it claims it. A claimed card shows who holds it, and another agent can't take it until the claim ends. A claim ends when its holder releases it, when its lease runs out because the holder stopped, or when the card moves into a done column or is archived. This is the mechanism Fleet runs on.

Import issues (optional)

A project can pull its open issues onto the main board from GitHub, Linear or Kavanah.

  1. Right-click the project in the left sidebar and choose Project Settings….
  2. Find Issue tracker and pick GitHub, Linear or Kavanah.
  3. Give it a token: a key name from the Keys vault, or for GitHub, Use the gh CLI. A Kavanah key (kvn_live_…) comes from Kavanah → Settings → API keys.
  4. For GitHub, enter the repository as owner/repo. For Linear, enter the team key, such as ENG. For Kavanah, leave the project empty to import every task assigned to you, or enter one project's ref.
  5. Click Test connection, then Import issues.

Importing again updates the cards it made instead of duplicating them. Turn on Close the issue when its card is done if you want finished cards to close their issues. That's the only change TRMNLY ever makes to your tracker.

Check yourself

  • You added three cards and moved one with the right arrow key.
  • A card has a checklist, and its row shows the progress count.
  • The agent moved a card when you asked by its # number.
  • You undid a change with Undo.

Go further

  • Kanban — boards, claims, storage, and the kanban_* tools
  • Access keys — storing the token the issue tracker uses
  • Fleet — agents that work the board on their own