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

The card

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

Open a card to read what its run did, answer it, change its details or start it again. Everything about one piece of work is on the card: its notes, its run, its pull request, its comments and its history.

Open a card

  • Click it on the board, or select it with the arrow keys and press Enter.
  • Pick an item on Needs you.
  • Search for its key or title with ⌘K, or open its address: /card/WEB-12.

The card opens as a panel over the board. Press F to open it as a full page, and F again to go back. [ and ] open the previous and next card in the column. On a phone the card fills the screen. Its title shows in the header above it, beside Back, and you edit it under Properties. Only the action buttons stay pinned while you scroll.

The header

The top of the card holds what you need most:

  • The key, such as WEB-12. Click it to copy it.
  • The title. Click it to edit, then press Enter or click away to save. The toast has Undo.
  • The bell, to follow the card: its changes and comments go to your Activity. See Activity.
  • The arrows for the previous and next card, Open as a full page, and Close.

The second row says where the work is: the team, the workspace or branch, the pull request, and the run’s state with its machine and how long it has run. On its right are the card’s actions.

The card’s actions

The filled button is the one thing to do next. It changes with the card:

The card The button
done by hand Mark done
has a proposed plan Review plan
has outputs to approve Approve outputs
has a question or a permission waiting Answer, or Allow or deny
ran out of usage credits Switch model, or Retry later
has a live session waiting for you Reply
can’t start on this machine Run on another machine, Open machine or Copy approve command
failed Retry
has a clean review Merge now
has a pull request with conflicts, or ready to merge Resolve merge conflicts, or Merge
has a run going Open Claude (named after its agent), with Open terminal in its arrow menu
finished a turn Continue
finished Mark done
is a workstream Run steps
hasn’t run, or ran before Run, or Run again

When Autopilot builds the card’s team, a card before Ready shows Ready instead of Run, and a card in Ready shows no button: Autopilot starts it. See Autopilot.

Once the card has a run, Open Claude (or Codex, or Gemini CLI) stays beside the button, so the run’s conversation is always one click away.

The ⋯ menu

More actions (⋯) holds the rest. You see only the items that fit the card now:

Item Does
Start over Runs the card again from the start
Run steps Starts a workstream’s steps
Retry Runs a failed card again
Revise rejected outputs Sends the run back to redo the outputs you rejected
Cancel run Cancels a run still in the queue
Open terminal Opens the live session’s terminal in the board. Type lets you type in it if the card or its machine is yours; anyone else who can see the card watches, and their view says Watch only. The card’s history names who opened it. On a phone a wide terminal is scaled to the screen’s width; turn off Fit width for actual size
Interrupt Stops the agent’s current step and waits for you
Ask Andon about it On a phone: opens the Chat tab with this card as the subject. The Conversation row’s Ask Andon does the same
Focus in Orca, or Show in Terminal Brings the session forward on its machine
Stop Ends the session
Mark done Moves the card to Done
Move to machine… Moves the card’s work, run and branch to another of your machines
Remove workspace Deletes the card’s worktree on its machine. Uncommitted changes make it refuse; a scratch folder goes to the Trash
Close terminal, Unlink workspace Lets go of a terminal or a linked workspace
Remove from group, Split from group, Abandon group, Group with… Change the card’s PR group. See Teams, projects and PR groups
Make it a sub-task of…, Mark as duplicate… See Sub-tasks and relations
Re-place Asks Autopilot to place a Ready card again, with its group and what it waits for
Archive Archives the card, after asking. Its workspace goes too

When you move a card with a run going back to the Backlog or Ready, Andon asks whether to Stop work on it. The workspace and branch stay either way.

The run and its history

The wide column on the left is the card’s story:

  • Needs you, when the run is waiting on you: a question to answer, a permission to allow or deny, a finished turn to reply to, outputs to review. Its buttons answer it here.
  • Run: the live run, its state, machine and summary.
  • The history: every run, the changes people made, and the pull request with its pipeline (Build, Review, CI, Merge). Filter it with Runs or Changes.
  • The conversation, and the reply box once the run can take a reply. ⌘Enter sends it.
  • Sub-tasks, relations and a workstream’s steps, when the card has them.
  • The branch so far and the run’s outputs.

The rail

The narrower column on the right holds the card’s details in tabs. Tabs that don’t fit go under the strip’s More menu. Drag the line between the two columns to make the rail wider; Andon keeps the width in this browser.

Tab What it holds
Details The card’s properties, below
Notes What the card is about, in Markdown. See Card notes
Comments Talk between people, with the count. See Comments
Prompt What the run was told, when the card has a recipe
Context Files and screenshots the agent sees, with the count. Paste a screenshot anywhere in the card and it lands here
Links Pull requests, issues and documents linked to the card
Fields, or Inputs The team’s custom fields, or the recipe’s inputs when the team has no fields
Memory The lessons the last run was given. See Memory

Details

Property What it sets
Owner Who the card belongs to. Only the owner changes, runs or answers it
Column Where it is on the board. Moving it into Working starts it
Team, Project, Milestone Where it is filed. A card in Working, Review or Done keeps its team
Repo, Workspace Which repository and workspace its run uses
Done by Andon runs it; Me makes it a to-do you finish by hand
Recipe How it runs. None (plain to-do) means it doesn’t run
Mode Interactive (you can chat) or Background, or the recipe’s default
Agent, Model, Account Which coding agent runs it, on which model and subscription
Run on, Run in Which machine, or Automatic; and a new workspace or one already on the machine
Priority None, Low, High or Urgent
Cycle, Estimate See Planning
Due, Labels A date, and labels to filter by
Repeat Runs the card again on a schedule

On a phone the tabs are rows you open one at a time, and the properties are under Properties at the bottom.

The right-click menu

Right-click a card on the board, or press the keyboard’s menu key, to change it without opening it:

Item Choices
Open Opens the card
Done By Andon or Me
Recipe None (plain to-do) or a recipe
Mode Recipe Default, Interactive (you can chat) or Background
Move To A column. Columns Autopilot keeps for itself are shown but can’t be picked
Team No Team or a team. Off for a card in Working, Review or Done
Priority None, Low, High or Urgent
Due Today, Tomorrow, In a Week or No Due Date

A card done by hand has no Recipe or Mode. On someone else’s card the menu has only Open. In the desktop app the menu is the system’s own. A long press on a touch screen starts a drag instead.