Guide

A Kanban Board for Claude Code: See Every Agent Session as a Card

Past two parallel sessions, the problem stops being running Claude Code and becomes tracking it. Sessions are work items with state, and the natural UI for work items with state is a board.

By Kylian Migot · Updated July 2026 · 8 min read

Quick answer

Claude Code has no built-in kanban board; a board comes from an orchestrator layered on the CLI. The case for one is simple: each session is a work item with a spec, a branch, a status, and a review state, and terminals hide that state while a board shows it. AIDEN is one such board; Nimbalyst and the Vibe Kanban community fork are the honest alternatives.
Built into Claude Code?
No, boards come from an orchestrator layered on the CLI
When a board pays off
Around 3+ concurrent sessions; two tabs are fine for two
The landscape
Vibe Kanban (shut down 4/2026, fork lives) · Nimbalyst (free/OSS) · AIDEN
AIDEN's columns
Stories → Spec Review → In Progress → Review → Done
01

Why a Board Is the Natural UI Past Two Sessions

A Claude Code session is not just a process, it is a work item with state. At any moment it has a task it was given, a branch it is writing to, a status (planning, coding, waiting on a permission prompt, finished, failed), and a growing diff that will eventually need your review. One session holds all of that in your head fine. Two, barely. At three or four, the state outgrows memory, and the tool you are using to view it, a terminal, is actively working against you.

Terminals hide state. A terminal shows you one session's most recent output, and only for the tab you happen to have focused. Everything that matters for managing parallel work, which session is stalled, which finished twenty minutes ago, which diff is getting dangerously large, is invisible until you go tab-by-tab and reconstruct it. A kanban board is the opposite trade: it shows less of any one session's output and all of every session's state, at a glance, in columns that literally are the status. This is why boards won for human teams tracking work items, and the argument transfers directly, agent sessions are work items that change state faster.

To be clear about scale: two occasional sessions do not need this, two tabs are fine, and we say so in the FAQ below. The board is the answer for when parallel sessions are routine. The broader escalation path from tabs to tmux to worktrees to a board is mapped in managing multiple Claude Code sessions, and the general case for agent-native boards, beyond Claude Code specifically, is in AI kanban for developers.

02

What a Card Should Track

A board is only as useful as its cards. A card that just shows a title is a to-do list wearing columns. For agent sessions, the card has to mirror the session's real state, which means tracking six things:

The story

The plain-language unit of work: what this session was asked to build. This is the card's identity, and it should be one deployable slice, not a project.

The spec

The written, approved plan the agent is executing: goal, acceptance criteria, boundaries. Without it on the card, review means reverse-engineering intent from a diff.

Branch / worktree

Where the work physically lives. Every session needs its own branch and, on a shared repo, its own worktree, and the card is where you see the mapping without running git commands.

Session status

Live agent state: planning, coding, running tests, waiting on you, exited. A stalled session should look different from a working one from across the room.

Diff size

A running sense of how much the session has changed. A card quietly accumulating a 3,000-line diff is a review problem forming, and you want to see it before the agent finishes.

Review state

Whether the finished work has been read, sent back with comments, or turned into a PR. This is the state terminals lose completely, a closed tab has no review state at all.

Notice that half of these, spec, branch, review state, are not things the CLI shows you even in a focused tab. They live in your head or in git. Moving them onto a card is the actual value of the board; the columns are just the index.

Ship your first agent today

Download AIDEN free and point it at your existing Claude Code or Codex setup. No credit card, running in minutes.

Download AIDEN free

Free to start · macOS 12+ · No credit card required

03

The Landscape, Honestly

AIDEN did not invent this category, and pretending otherwise would be silly. Vibe Kanban defined it: an open-source board whose cards were coding-agent tasks, running Claude Code and other CLIs, and it proved the model well enough that "kanban for coding agents" became a phrase people search for. Vibe Kanban shut down in April 2026. A community fork keeps the code alive for people who want to self-maintain, and our Vibe Kanban alternative page walks through the migration options in detail.

Nimbalyst fills the free-and-open-source niche today: MIT-licensed, cross-platform, a kanban view over agent sessions. If your requirement is "open source or nothing," it is the honest recommendation, and we compare it fairly on the desktop apps for coding agents roundup. AIDEN's bet is different: not just a board over sessions, but a process around them, a spec gate before any agent codes, automated worktrees, and mixed Claude Code and Codex fleets, which is the next section.

04

AIDEN's Board: Five Columns and a Gate

AIDEN's board runs Stories → Spec Review → In Progress → Review → Done. The shape is deliberately boring, it mirrors how a story actually flows through an agent, and the load-bearing part is the gate between the first two columns and the rest: no agent starts coding until you have approved a written spec on the card.

The spec gate

AIDEN drafts a spec from your story, goal, acceptance criteria, boundaries, and the card sits in Spec Review until you edit and approve it. Planning and execution are physically separated on the board, which is what makes review possible later: you check the diff against a contract, not a vibe.

Cards mirror live sessions

In Progress cards show the branch, the agent's current action, and a live output tail. Sessions that stall on a permission prompt or exit on an error become cards that visibly need you, no tab polling.

Worktree per story, automated

Each card gets its own git worktree and branch when it enters In Progress, and AIDEN cleans up after merge. The isolation discipline the community recommends becomes a side effect of using the board.

Runs Codex too

Cards are assigned to your Claude Code CLI or your Codex CLI, same board, same gate, same review flow. If your fleet spans both vendors, this is the single surface that covers it.

The board is the visible part; the orchestration underneath, how stories are queued, how branches become PRs, is covered in Claude Code orchestration.

05

From CLI to Board in Four Steps

  1. 1

    Install AIDEN next to your CLI

    AIDEN is a macOS desktop app (macOS 12+, Apple Silicon and Intel) that runs on top of the Claude Code you already have, your CLI, your login, your usage limits. Codex CLI is optional but supported the same way.
  2. 2

    Point it at a repo and add stories

    Create a project from a local git repository, then write one card per unit of work. Specific stories, "Add rate limiting to /api/checkout", produce specs an agent can actually be held to.
  3. 3

    Approve specs, let cards flow

    Each story gets a drafted spec in Spec Review. Edit, approve, and the card moves to In Progress on its own worktree and branch. Run one card or several, the board is useful either way.
  4. 4

    Review diffs from the Review column

    Finished cards land in Review with the full diff and the spec side by side. Read, send back with a comment, or open a PR in one click. Merged cards move to Done and their worktrees are cleaned up.

FAQ

Does Claude Code have a built-in kanban board?
No. Claude Code is a terminal CLI, and even its experimental Agent Teams mode coordinates sessions inside the terminal with shared task lists, not a visual board. A board comes from a layer above the CLI: an orchestrator app like AIDEN or Nimbalyst that runs Claude Code sessions and renders each one as a card.
What was Vibe Kanban?
Vibe Kanban was the open-source project that defined the category: a kanban board whose cards were coding-agent tasks running Claude Code and other CLIs. It shut down in April 2026; a community fork keeps the code alive. Its shutdown is the reason many people searching for a Claude Code kanban today are choosing between the fork, Nimbalyst, and AIDEN. Our Vibe Kanban alternative page covers the options.
Can one board run Claude Code and Codex agents together?
Yes, if the board is built for it. AIDEN assigns each card to either your Claude Code CLI or your Codex CLI, so a mixed fleet shares one board, one spec gate, and one review flow. Claude Code's own Agent Teams cannot do this: it is Anthropic-only. If you run both CLIs, a vendor-neutral board is the only single management surface available.
Do I need a kanban board for just two Claude Code sessions?
Honestly, no. Two sessions fit comfortably in two terminal tabs, especially on separate repos, and adopting an orchestrator for that scale is overhead without payoff. The board starts earning its place around three or more concurrent sessions, or earlier if you keep losing track of which session was doing what, which is a sign the state has already outgrown your terminals.
Is AIDEN's kanban board free?
The free tier includes one project with the full board, the spec approval gate, and orchestration of both Claude Code and Codex, no credit card required. You bring your own CLI and your own subscription or API key; AIDEN runs on top of them. Solo is $19/mo for unlimited personal projects.

Keep reading

Give your sessions a board.

AIDEN runs your Claude Code and Codex CLIs as cards on a kanban board, spec gate before code, worktree per story. Free for one project.

macOS 12+ · Bring your own Claude Code or Codex · Your code stays local