---
title: "Keyboard shortcuts"
description: "Every binding in the list, in a session, in review, and in quick prompt mode."
canonical: "https://agent-manager.dev/docs/keys/"
last-updated: "2026-10-25"
section: "Documentation"
source: "agent-manager"
---

# Keyboard shortcuts

Everything is one key from the list. `?` shows this inside the app. The mouse works too. A click on a session row or its preview focuses it, a double click on a group folds or unfolds it, a row drags by its `⠿` handle (`=` with Compatible symbols), `[…]` or a right click opens a row's actions, a click on `messages` in the key legend opens the messages panel while any message is left, and a press on the divider between the list and the preview drags it. The full-screen layout selects on a click and focuses on a double click. The wheel stays inside the app: a notch moves the cursor in the list, scrolls the diff, and in a focused session walks that pane's scrollback, where click-drag selects pane text and copies it. Settings has a `mouse` row, on by default, that hands the mouse back to the terminal.

Every other screen takes the mouse the same way. A click on a key in a footer, a card's foot, the bottom edge of Messages or a pill in Review's header runs that key. In a list inside a card (Settings, CLIs, Keybindings, saved prompts, Move, Review's pickers, Messages) the first click picks a row and the second runs it, and the wheel moves the cursor. In Review a click opens a file or moves to a code line. A click beside a card closes it the way `esc` does, except a form holding typed text. Keys, cards and menu entries act when the button comes back up, so a press that slides off does nothing.

![Animated demo: the wheel moves the cursor, a click focuses a session, a click on its row comes back, the ⠿ handle drags a row within its group and into another one, and […] opens the row's actions.](/assets/demo-mouse.gif)

_Fig. 1mouse · focus, drag, row actions_

## The list

| Key | Action |
| --- | --- |
| ↑↓ / j k | Move the cursor. |
| → | Step into the row: focus the session, or open the group. In beta; Settings (`s`) turns the pair off. |
| ← | Step out: close the group, or, inside a focused session with the caret at the start of the agent's prompt, come back to the list. Anywhere else in the prompt it moves the caret as usual. |
| K / J | Reorder the session or group among its visible siblings. `shift+↑↓` does the same. |
| enter | Focus the session in place, so keys go to the agent and the list stays. On a group, fold it. |
| A | Attach the session full screen. Settings can swap this with `enter`. |
| F | Fold or unfold every group. |
| e | Hide or show empty groups. |
| n | New session: name, tool, the model, effort and profile the tool offers, directory, worktree toggle and the base it starts from, optional saved prompts and starting prompt, group. |
| T | New terminal tab: a shell under the selected agent, or in the selected group. |
| o | Open the selected row's directory in your editor. |
| w | Keep only the waiting, finished and errored rows. Press again to show all. |
| g | New group: name, parent, default path, worktree default, worktree base. |
| C | New SSH connection: another machine's sessions in this list. See [Sessions](/docs/sessions/#ssh). |
| r | Rename a session or cycle its tool; edit a group's name and default path. |
| m | Move a session to a group, a terminal into a session, or a group under another group. |
| / | Search by name. The field takes a fill of its own while it is open, and the query lights up inside every row that matched on its name. |
| \| | Resize the split: `←→` nudge, `enter` commits, `esc` cancels. |
| s | Settings: default tool, theme, theme follows OS, background, list density, sessions layout, header, computer stats, review layout, after quick prompt, session keys, ←→ step in/out, mouse, spawn in worktree, fetch on spawn, coordination, notifications, notify on finish, editor, keybindings, CLIs, saved prompts, symbols, docs, report a bug, suggest a change, and the version row that updates in place. |
| M | Messages: updates, maintainer messages and tips. New notices open on their own. While one is unread, the View footer paints `M unread` as a filled chip, and a click on it opens the same panel. `↑↓` pick one, `pgup/pgdn`, `home/end` and the wheel scroll it, `enter` opens its link, `u` updates and restarts, `r` refreshes, `x` dismisses one for good. On an update message, `Press u to update to vX.Y.Z and restart.` and the footer's `u update` draw in the key color. No other message has `u update` in its footer. |
| ? | Keys overlay. It scrolls (`↑↓`, `pgup/pgdn`, `g/G`) and `/` searches it down to one line. `o` opens the docs and leaves the overlay up. The docs row in Settings opens the same page. |
| q | Quit, leaving every agent running. |
| ctrl+c | Quit, leaving every agent running. A focused session sends it to the agent, and the manager stays up. |

## Sessions

| Key | Action |
| --- | --- |
| space | Quick prompt on a session, or spawn an agent on a group. |
| . | Mark a finished session idle without entering it. |
| y | Copy the newest reply to the clipboard while you stay on the list. |
| ctrl+r | Review this session's changes. |
| x / X | Kill this session (or a group's), or every live session in view. |
| v / V | Revive this session (or a group's), or every dead session in view. |
| f | Fork the conversation into a named session in the same group and directory. |
| R | Restart the session on an empty context: same name, group, directory and tool. |
| a / u | Archive / restore a session or group. Archive kills the process and keeps the last preview; restore resumes it. |
| c | Keep a session that asked to be archived or killed once its turn ends. |
| t | Toggle the archived view. |
| d | Delete the record, or a group and its subtree. |
| ctrl+q / ctrl+\ | Inside a session: back to the manager when the terminal leaves the key available. |
| ctrl+c | Inside a focused session, send ctrl+c to the agent. The manager stays up. |
| pgup / pgdn | Inside a focused session on its normal screen, walk that pane's tmux history when it has some and has not claimed mouse input. Otherwise the agent gets them. `alt+pgup` and `alt+pgdn` always reach the agent. |
| F3 | Inside a session: open its directory in your editor. |
| F4 | Inside a session: pick a saved prompt and paste it without sending. |
| click / double click | Focus a session from its row or its preview, or fold a group. The full-screen layout selects on a click and focuses on a double click. Focused beside the list, a click on another row focuses that one, a click anywhere else in the list column returns to the list, and the mouse back button returns in either layout. |
| drag ⠿ / = | Reorder the row, drop it into another group, or nest a terminal under an agent. `esc` puts it back. |
| […] / right click | The row's actions, each with its key beside it: attach, prompt, copy the last reply, review, fork, new terminal, editor, rename, move, restart, archive, kill and delete. |
| wheel / drag | Focused: the wheel walks that pane's scrollback and a drag selects its text and copies it. Double-click copies the word, triple-click the line, a click on a link opens it in your browser, and `alt+drag` passes the whole drag to an agent's own UI. A click on the preview beside the list leaves the link alone. Over SSH a clicked link prints on your terminal and reaches your clipboard through OSC 52, and so do copies. |

## Review

| Key | Action |
| --- | --- |
| ↑↓ / j k | Scroll the file. |
| ctrl+d / ctrl+u | Half a page. |
| g / G | Top, bottom. |
| J / K | Next, previous file. `tab` and `shift+tab` do the same. |
| n / N | Next, previous change. |
| u | Side by side or unified. |
| s | Cycle the diff scope. |
| r / b / B | Repo, branch, merge target. |
| space | Mark the file reviewed. |
| f | Show code files only, hiding images, compiled assets and lock files; press again to show them. |
| c / d | Write or drop a draft. On a sent comment, mark it handled or open. |
| C | Send the current drafts as one numbered round. |
| o / F3 | Open the current file in your editor. |
| esc / q | Close the review. |

## Quick prompt

| Key | Action |
| --- | --- |
| enter | Send, or spawn in the group. |
| ↑↓ | Retarget while the bar stays open, or move the caret in a taller prompt. |
| tab | Step the spawn tool forward (`alt+m` also works). |
| shift+tab | Step the spawn tool back one. |
| ctrl+l | Pick the spawn's model from the ones the tool lists. Typing filters the list. |
| ctrl+x | Step the spawn's reasoning effort through the model's levels. |
| ctrl+y | Step the spawn's profile, for a tool that has them. |
| ctrl+t | Toggle worktree spawn on a group row (`alt+w` also works). |
| ctrl+o | Pick a saved prompt. It sits in the bar as a chip and becomes its text when you send. |
| ctrl+v | Paste a clipboard image as a chip. |
| backspace | Next to a chip, remove the whole chip. `delete` removes the chip after the caret. |
| ←→ | Step over a chip as one token. |
| esc | Close the bar. |

## Dialogs

The new session, new group, rename, fork and move forms all take the same four keys.

| Key | Action |
| --- | --- |
| tab / ↑↓ | Next field. |
| ←→ | Change a picker's value. |
| enter | Confirm. |
| esc | Cancel. |