Keybindings

This page lists keyboard shortcuts for each Agentty view.

For session states and transition behavior, see Workflow.

Session List🔗

| Key | Action | |-----|--------| | q | Quit | | a | Open session creation selector | | s | Sync active project branch | | c | Cancel the selected running session, review session, or unstarted draft session (confirmation popup) | | Enter | Open session | | j / k | Navigate sessions | | Tab | Switch tab | | ? | Help |

Project List🔗

| Key | Action | |-----|--------| | q | Quit | | Enter | Select active project | | j / k | Navigate projects | | Tab | Switch tab | | ? | Help |

The currently active project is highlighted in the table with a * prefix and accented row text, even while cursor selection moves to other rows.

On the Sessions list, a opens a popup with Regular, Draft, and Stacked. Stacked is enabled only when the selected session is a root session with an active branch. Enter chooses the highlighted option, j / k or Up / Down move between enabled options, and Esc / q closes the popup.

On the Sessions list, c appears only when the selected row is cancelable: running sessions, review-ready sessions, and draft sessions that are still in Draft before their first staged bundle starts.

Settings🔗

| Key | Action | |-----|--------| | q | Quit | | j / k | Navigate settings | | Enter | Edit setting / finish text edit | | Esc | Finish text edit | | Alt+Enter or Shift+Enter | Add newline while editing Open Commands | | Up / Down / Left / Right | Move cursor while editing Open Commands | | Tab | Switch tab | | ? | Help |

The Settings tab includes:

The page is split into Global settings for the app-wide Theme row and '<project>' settings for rows stored against the active project.

Theme to switch the whole terminal UI between Agentty Default, the green terminal-inspired Agentty Green palette, and the warm navy Dark Horizon palette inspired by the Horizon editor theme. Agentty uses Agentty Default by default.
Default Reasoning Level (low, medium, high, xhigh) for Codex and Claude turns in the active project.
Default Smart Model, Default Fast Model, and Default Review Model for the active project. Default Smart Model can also cycle to Last used model as default.
Coauthored by Agentty to enable or disable the Co-Authored-By trailer on generated session commit messages for the active project. New projects start with this disabled.
Open Commands for launching session worktrees in the active project (one command per line).

Review🔗

| Key | Action | |-----|--------| | q | Quit | | s | Refresh PRs/MRs requesting your review for the active project | | Tab | Switch tab | | ? | Help |

The Review tab is read-only: it lists matching GitHub pull requests and GitLab merge requests, including drafts marked with Draft, but does not select rows or open browser links. GitHub rows are separated into direct review requests and team-sourced review requests. Open a listed review from the forge UI or CLI.

Session View🔗

Available actions depend on the session state. The full set in Review state:

| Key | Action | |-----|--------| | q | Back to list | | Enter | Compose the first prompt or reply; in draft sessions it adds a draft; while the session is InProgress it opens the composer to queue the next chat message inline with a queued › prefix | | / | Open the composer with / prefilled for slash commands | | s | Start a staged draft session | | o | Open worktree in tmux when the session worktree exists | | p | Publish session branch and create or refresh forge review request | | d | Show diff | | f | Append focused review output (regenerate if already present) | | m | Add to merge queue (confirmation popup) | | r | Rebase | | j / k | Scroll output | | g | Scroll to top | | G | Scroll to bottom | | Ctrl+d | Half page down | | Ctrl+u | Half page up | | Ctrl+c | During InProgress: while the queue has staged chat messages, each press retracts the most recently queued message (LIFO) and leaves the running turn alone; once the queue is empty, the next press stops the current turn and returns the session to Review | | ? | Help |

During AgentReview, Agentty keeps the same review-oriented shortcuts but hides r until the background focused-review generation finishes and the session returns to Review.

Additional notes:

Open command behavior: o opens the session worktree in tmux when a local worktree is available and the session is not actively running, rebasing, queued, or merging. If one Open Commands entry is configured for the active project, it runs immediately. If multiple entries are configured (one command per line), Agentty opens a selector popup. Run Agentty in tmux when you rely on Open Commands, because those commands are dispatched into tmux windows.
Draft sessions: sessions created through the a selector do not create a worktree until you press s to start the staged bundle, so o stays hidden before the first live turn. Stacked drafts can stage messages immediately, but s stays unavailable until the parent session is merged and the draft is restacked onto the base branch. Their action list also hides m and r while the parent link is still set.
Forge review-request publish: p is available in Review and AgentReview and opens a publish popup. Press Enter with an empty field to keep the default session branch target, or type a custom remote branch name first. Agentty pushes the branch, then creates or refreshes the linked forge review request after the push succeeds. When no request is linked yet, only an open same-branch request is reused. GitHub projects publish pull requests, while GitLab projects publish merge requests.
Focused review persistence: when a focused review has already been generated, it stays visible after opening d diff mode, returning to the session view, or entering Question mode for clarifications.
Branch publish lock: once a session branch already tracks a remote branch, Agentty locks the popup field and re-publishes to that same remote branch only.
Branch publish auth: p always runs git push first. HTTPS remotes therefore need Git credentials even when the forge CLI is already logged in. Review-request publishing also needs authenticated gh access for GitHub repositories and authenticated glab access for GitLab repositories. See Forge Authentication for the GitHub and GitLab CLI setup steps.
Question: opening the session enters Question Input mode until all prompts are answered and submitted, the clarification turn is ended with Ctrl+C, or the user exits to the sessions list with q.
Done: c opens a yes/no confirmation, then creates a new draft composer with the continuation text already staged as the first draft message. When Agentty has the merged hash, including the session branch HEAD hash captured when a synced GitHub PR or GitLab MR is already merged, that staged message is Summarize changes from <full-hash> to use it as an initial context for this session; otherwise it falls back to the saved summary/transcript.
Canceled: continuation is unavailable; use q, scroll, or help from the read-only session view.
Review: Runs in read-only review mode. It can use internet lookup and non-editing verification commands, but it should not edit files or mutate git/workspace state.

| Key | Action | |-----|--------| | Enter | Publish using the typed branch name, or the default session branch target when left blank | | Esc / q | Cancel and return to session view | | Left / Right / Home / End | Move cursor | | Up / Down | Move cursor across wrapped lines | | Backspace / Delete | Delete character | | text keys | Edit remote branch name |

Open Command Selector🔗

| Key | Action | |-----|--------| | j / k | Move selection | | Enter | Open worktree and run selected command | | Esc / q | Cancel and return to session view |

Diff Mode🔗

Pressing d from session view opens diff mode with the right panel showing the git diff. Pressing c from session view opens the same diff mode but with the right panel switched to review-request comments. Within diff mode, press c to toggle the right panel between the git diff and the cached review-request comments without leaving the page.

| Key | Action | |-----|--------| | q / Esc | Back to session | | j / k | Select file | | Up / Down | Scroll selected panel | | c | Toggle right panel between diff and comments | | ? | Help |

When the right panel shows the git diff, its title includes aggregate line totals as +added and -removed counts for the current session diff, and cached pull-request or merge-request line comments are rendered inline below matching diff lines. When the right panel shows review-request comments, it lists the same cached inline threads as an overview plus pull-request-level or merge-request-level "General discussion" comments. Resolved inline threads are hidden from both views. The comments panel is read-only; replies must happen on the forge web UI. Comment threads are fetched by the background review-request sync task and are pre-sorted by file path, line, and diff side.

Prompt Input🔗

| Key | Action | |-----|--------| | Enter | Submit the first prompt in a regular session that is still Draft, stage one prompt in a draft session that is still Draft, or submit reply/question text elsewhere | | Alt+Enter or Shift+Enter | Insert newline | | Ctrl+V, Ctrl+Shift+V, or Alt+V | Paste one clipboard image as an inline [Image #n] placeholder | | Cmd+Left | Move to start of current line | | Cmd+Right | Move to end of current line | | Option+Left | Move to previous word | | Option+Right | Move to next word | | Option+Backspace | Delete previous word | | Cmd+Backspace | Delete current line | | Esc | Cancel | | @ | Open file picker | | / | Open slash commands |

Prompt input keeps regular text paste on terminal Event::Paste. The dedicated image paste shortcuts insert highlighted [Image #n] tokens directly in the composer and send the referenced local image for Codex, Gemini, and Claude session models. On Linux, clipboard image capture supports both X11 and Wayland data-control clipboard backends, including Wayland compositors such as Hyprland. Codex and Gemini preserve the multimodal ordering at transport level, while Claude rewrites the placeholders to local image paths before streaming the prompt.

When the current session was created as Draft, pressing Enter stages the current composer contents into the draft bundle and returns to session view. Use s from session view to launch the staged bundle as the first live turn. For a Stacked draft, that start action is blocked until its parent has merged. Sessions created as Regular start immediately on the first Enter.

Question Input — Option Selection🔗

When predefined options are shown:

| Key | Action | |-----|--------| | j / k / Up / Down | Navigate options | | Enter | Choose highlighted option | | Tab | Switch focus to chat output for scrolling | | q | Return to the sessions list | | Ctrl+C | End turn — return to review without answering |

Question Input — Free Text🔗

After moving above or below the predefined option list, or when no predefined options exist:

| Key | Action | |-----|--------| | Enter | Submit typed response | | Alt+Enter or Shift+Enter | Insert newline | | Ctrl+J / Ctrl+M | Insert newline (macOS terminal compat) | | Ctrl+C | End turn — return to review without answering | | Left / Right | Move cursor | | Up / Down | Move cursor across wrapped lines | | Backspace / Delete | Delete character | | Home / End | Move cursor to start/end | | Cmd+Left | Move to start of current line | | Cmd+Right | Move to end of current line | | Option+Left / Option+Right | Move to previous / next word | | Option+Backspace | Delete previous word | | Cmd+Backspace | Delete current line | | Ctrl+K | Kill to end of current line | | Ctrl+W | Delete previous word | | Ctrl+D | Delete character forward | | Tab | Switch focus to chat output for scrolling |

In free-text mode every other printable character — including q — is inserted into the answer so responses can contain it. To exit the question without answering, press Tab to focus the chat output (or navigate back into the option list when the question has predefined options) and then press q, or press Ctrl+C from any focus to cancel the turn.

Question Input — Chat Scroll🔗

When chat output is focused (press Tab to switch):

| Key | Action | |-----|--------| | j / k / Up / Down | Scroll chat output | | g | Scroll to top | | G | Scroll to bottom | | Ctrl+d | Half page down | | Ctrl+u | Half page up | | d | Open diff preview for the current session | | Enter / Esc | Return focus to answer input | | Tab | Switch focus back to answer input | | q | Return to the sessions list | | Ctrl+C | End turn — return to review without answering |

After the last question is answered, Agentty sends one follow-up message to the session with each question and its response, then returns to session view. Pressing Ctrl+C at any point ends the turn immediately without sending a reply and returns the session to review. Pressing q (outside free-text input) returns to the sessions list while leaving the session in Question state so the clarification can be resumed by reopening it.