# The card

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](https://andon-docs.pages.dev/guide/needs-you.md).
- 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](https://andon-docs.pages.dev/guide/activity.md).
- 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](https://andon-docs.pages.dev/guide/autopilot.md).

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](https://andon-docs.pages.dev/guide/teams-projects-and-pr-groups.md) |
| **Make it a sub-task of…**, **Mark as duplicate…** | See [Sub-tasks and relations](https://andon-docs.pages.dev/guide/subtasks-and-relations.md) |
| **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](https://andon-docs.pages.dev/guide/notes.md) |
| **Comments** | Talk between people, with the count. See [Comments](https://andon-docs.pages.dev/guide/comments.md) |
| **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](https://andon-docs.pages.dev/guide/fields.md), or the recipe's inputs when the team has no fields |
| **Memory** | The lessons the last run was given. See [Memory](https://andon-docs.pages.dev/guide/memory.md) |

### 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](https://andon-docs.pages.dev/guide/planning.md) |
| **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.
