Skip to content
AndonDocs
GitHub
Use the board / The board and doing work

The board

View as MarkdownThe same text, at this page's address plus .mdOpen in ClaudeAsk questions about this pageOpen in ChatGPTAsk questions about this page

The board shows every card your teams are working on, in columns from idea to done. Moving a card between columns is how you tell Andon what to do with it: a card moved into Working starts running on a machine.

The columns

Each column has a role. The role, not the column’s name, decides what Andon does with a card there.

Column What happens there
Backlog New cards and captures wait here. Press B to show or hide it
Ready Cards that are ready to build. They wait until you run them, or until Autopilot starts them
Working Moving a card here starts its run
Review Finished runs wait here for you, with their outputs or pull request
Done Approved work. The board shows the five newest; Show more under the column shows the rest

A workspace can also have an Inbox, where captures land, and a Next column. Simplify to the 4-column layout on the Columns page (below) removes them and hides the Backlog.

Add a card

  • Press N: a new card goes to the Backlog, which opens if it is hidden.
  • Click New card in the toolbar, or use a column’s add row and, when the team has card templates, its New from template….
  • Press W for Start work, which makes a card, an import or a plan from one sentence.

Move a card

  • Drag it to another column, or to another place in its column.
  • Select it and press a number: 1 moves it to the first column shown, 2 to the second, and so on.
  • Right-click it and pick Move To.
  • Open it and change Column in its details.

Every move shows a toast with Undo. While Autopilot builds a team, Andon moves that team’s cards into Working and Review itself, so those columns are shown but can’t be picked in the menus. See Autopilot.

Dropping a card onto another card can also group the two into one pull request, or make one a sub-task of the other. See Shortcuts.

What a card shows

A card on the board shows its key and title, its team and project, its labels, and its run: a badge with the run’s state, such as working, waiting for you or failed. A card that needs you pulses amber. Cards that ship together in one pull request are stacked: click the stack to open it.

The board’s toolbar switches the layout (Board, List or Timeline), filters it, picks cards with Select, and opens Autopilot. See Views, the filter bar and swimlanes to filter the board, save views and split it into lanes by team or project.

Card keys

Every card has a key made of its team’s key and a number: WEB-12 is the twelfth card in the team whose key is WEB. A card with no team takes the workspace’s key. Numbers are given when the card is made and never reused.

Use the key anywhere you’d name the card:

  • ⌘K finds a card by its key.
  • /card/WEB-12 opens it.
  • The andon command takes it: andon run WEB-12.
  • Branches carry it: andon-web-12-<title>.
  • A pull request names it with Card: WEB-12 in its description.

A card imported from Linear or Jira keeps its tracker’s key, such as ENG-42, as a link chip, and gets an Andon key of its own. Search finds it by either.

Change a team’s key

  1. Open Settings → Teams, pick the team, and find Key under Identity.
  2. Type 2 to 5 letters or digits. The line under it shows what the cards’ keys will look like.

The team’s cards take the new key. Their old keys keep working, in search, in links and on the command line. A card that moves to another team takes that team’s next number, and its old key keeps working too. Only owners and admins change keys.

Team statuses

A team can split a column into its own statuses, such as In progress and In QA in Working. Each status belongs to one column, and each column a team uses has one default status.

Add a status

  1. Open Settings, search for Team statuses, and pick it. The Columns page opens.
  2. Pick the team in Team.
  3. In the column you want, type the status’s name in Add a status to … and press Enter.
  4. Pick its colour from the dot beside it: gray, blue, violet, amber or green.

Changes save as you make them. You can also rename a status, move it to another column, move it up or down, and Make default. Only owners and admins change statuses.

How the board shows them

Filter the board to one team and each column with two or more of its statuses splits into them, under the column’s name. Drag a card between two statuses of a column to change its status and nothing else. Elsewhere, a card shows its status as a chip.

When Andon moves a card, it lands on the default status of its new column. A status you picked stays while the card stays in its column.

A sub-team with no statuses of its own uses its parent’s. Once it adds one, its cards stop using the parent’s.

Fill new cards from a template

Under a status, A card landing here gets picks a card template. A card that lands in that status is filled from the template once.

Write back a status to Linear or Jira

Write-back moves a linked issue by column. To use a tracker state of your own instead, click the link icon on a status and type the Linear state or Jira status to use while a card is in it.

Delete a status

Click the bin on its row and pick where its cards go. They stay in their column. The delete is recorded in the audit log.

Columns

Search Settings for WIP limit or Column role, or open /settings/columns, to change the workspace’s columns. Owners and admins can rename a column, set its WIP limit, hide it from the board (Shown), change its Role, add one with New column, or Simplify to the 4-column layout: Ready, Working, Review and Done.