---
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-07"
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 focuses it, a double click on a group folds or unfolds it, a row drags by its `⠿` handle, `[…]` 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.

![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 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 | Filter to sessions that need attention; press again to show all. |
| g | New group: name, parent, default path, worktree default, worktree base. |
| 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, 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, and while any message is left, a click on `messages` in the key legend 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. |
| ? | Keys overlay. It scrolls (`↑↓`, `pgup/pgdn`, `g/G`) and `/` searches it down to one line. |
| q | Quit, leaving every agent running. |

## 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 session's newest reply to the clipboard, without attaching. |
| 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. |
| F3 | Inside a session: open its directory in your editor. |
| click / double click | Focus a session, 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 on the focused session's own row 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. 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, drop a line comment. |
| C | Send every comment to the agent. |
| 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+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. |