# Keyboard shortcuts

Andon is built to steer many agents without the mouse. Press `?` on the board to see this list in the app.

The board's keys work while no text field has the cursor and no card is open. A card's keys work while the card is
open. On a Mac, `⌘` is Command; elsewhere use Ctrl.

## Anywhere

| Key | Does |
|---|---|
| `W` | Opens [Start work](https://andon-docs.pages.dev/guide/start-work.md): a card, an import or a plan from one sentence |
| `⌘K` | Searches everything: cards, issues, teams, pages and settings |
| `⌘J` | Opens the chat with the machine or the assistant over any page. Esc closes it |

## On the board

| Key | Does |
|---|---|
| `N` | Adds a new card to the Backlog, opening the Backlog if it is hidden |
| `/` | Searches cards by title, team, machine or status, and PR groups by name or a member's key |
| `F` | Puts the cursor in the filter bar, where you type `assignee:me label:bug` and the rest (see [Views](https://andon-docs.pages.dev/guide/views.md)) |
| `⌘S` | Saves the filter, layout and grouping as a view, or saves changes to the open view |
| `B` | Shows or hides the Backlog |
| `D` | Opens the [Dashboard](https://andon-docs.pages.dev/guide/dashboard-and-phone.md) |
| `?` | Opens the shortcut list |

## Move around the board

| Key | Does |
|---|---|
| `←` `↑` `→` `↓`, or `H` `J` `K` `L` | Selects a card. In the list layout, `J` and `K` move down and up |
| `.` | Selects the next card that needs you, in board order |
| `Enter` | Opens the selected card. On a PR group's stack, opens or closes the stack |
| `Esc` | Clears the picked cards or the selection, or closes what is open |

## Act on the selected card

| Key | Does |
|---|---|
| `R` | Runs the selected card. A failed card runs again. When Autopilot builds the card's team, `R` moves it to Ready instead, and a card already in Ready waits for Autopilot. A workstream starts its steps |
| `C` | Opens the card on its reply box, to continue the run |
| `T` | Opens the terminal of the card's live session |
| `A` | Approves the card's outputs |
| `1` to `7` | Moves the card, or the picked cards, to the column at that position. The toast has Undo |
| Right-click | Opens the card's menu: **Open**, **Done By**, **Recipe**, **Mode**, **Move To**, **Team**, **Priority** and **Due** (see [The card](https://andon-docs.pages.dev/guide/card.md#the-right-click-menu)) |

## Work with several cards

| Key | Does |
|---|---|
| `X`, or ⇧-click | Picks the selected card, to change, move, run or archive several at once |
| `⌘A` | Picks every card in the selected card's column |
| `E` | Opens **Set** on the picked cards: status, priority, labels, cycle, milestone, estimate or a field |
| `G` | Groups the picked cards into one pull request. The toast has Undo |
| `⇧G` | Takes the picked cards out of their planned group, or undoes the selected stack |

See [Card templates and bulk edit](https://andon-docs.pages.dev/guide/templates-and-bulk-edit.md) for the selection bar.

## Dragging

| Hold while you drop | Does |
|---|---|
| nothing | Moves the card: reorders it, or changes its column |
| still for 600 ms over a card in the same column | Groups the two cards into one pull request. The target says *Hold to group with WEB-3* until then |
| `⇧` | Groups at once, in the same column |
| `⌥` (Alt) | Makes the card a sub-task of the card you drop it on |

A drop into another column only moves the card.

## In an open card

| Key | Does |
|---|---|
| `⌘Enter` | Sends the reply, or runs the card |
| `[` and `]` | Opens the previous or next card in the column |
| `F` | Opens the card as a full page, or goes back to the board |
| `S` | Adds a sub-task |
| `B` | Adds a relation: **Blocked by**, **Blocks**, **Duplicate of** or **Related** |

The notes editor has its own keys for bold, links, lists and the rest: see [Card notes](https://andon-docs.pages.dev/guide/notes.md).
