# Keys Every key, by where the focus is. Each command is in the palette (`ctrl+shift+p`) under an id that `[keys]` rebinds ([06-config.md](06-config.md#keys)); `?` shows a summary in the TUI. [Focus](#focus) · [Everywhere](#everywhere) · [Lists](#sidebar-lists) · [Views](#views) · [Terminals](#terminals) · [Files](#in-a-file) · [Vim](#vim-mode) · [Pickers](#pickers-menus-questions) · [Mouse](#mouse-and-clipboard) ## Focus A key means what the focused part makes of it (`keyContext`, `keybindings`): - a session or the Terminal panel: every key but the chords marked T below - an editable file: printable keys type; ctrl and F-keys stay commands - a text box (commit message, filter, find): its own keys; `[keys]` waits - a sidebar list, a diff, a rendering: single letters and every chord Without the kitty keyboard protocol ``ctrl+` `` and `ctrl+space` are one byte: an editable file takes it as suggestions (the panel is on `ctrl+j` there), a terminal as the panel (its `ctrl+j` is the app's line feed). Inside tmux the protocol needs `set -s extended-keys on` and `set -as terminal-features ",*:extkeys"`. With those, an esc that a mouse report lands behind within `escape-time` reaches pando as `alt+esc` and the report as typed text: `unspill` makes it an esc again and drops the text. ## Everywhere T: also in a terminal; the rest are the shell's there. | Key | Action | | ------------------------------------------------------ | ------------------------------------------------------- | | `ctrl+]` T | cycle focus: left sidebar, each editor group, panel, … | | `ctrl+shift+p` T, `F1` | quick open's Actions; `ctrl+shift+p` over any modal too | | `F10` | Manage menu (⚙): palette, settings, keys, categories | | `ctrl+shift+e` `ctrl+shift+g` `ctrl+shift+f` T | Explorer, Source Control, Search | | `ctrl+shift+h` T | Search with replace | | ``ctrl+` `` T, `ctrl+j`, `5` (list, diff) | toggle the bottom panel | | `ctrl+shift+u` | the panel's Output | | ``ctrl+shift+` `` T | new shell in the panel | | `ctrl+shift+↑` `ctrl+shift+↓` T | maximize, restore the panel | | `ctrl+b` T, `ctrl+,` T | hide the sidebars, the Settings tab | | `ctrl+0` T, `ctrl+1`…`ctrl+9` T | focus sidebar, editor group N | | `ctrl+\` | split: the active tab into a new group on the right | | `alt+t` T | quick open's Sessions (`@idle`, `!claude` narrow) | | `alt+a` T | the next session waiting on you: blocked, failed, done | | `alt+i` T | saved prompts: `⏎` inserts, `alt+⏎` also submits | | `alt+n` T | new tab: a file, a session of the space, new or resumed | | `alt+s` T | new session in the space in view | | `ctrl+pgup` `ctrl+pgdn` T, `ctrl+shift+tab` `ctrl+tab` | previous, next editor | | `alt+1`…`alt+9` T | editor N | | `ctrl+shift+pgup` `ctrl+shift+pgdn` T | move the tab: editor, session tab, shell | | `ctrl+p` T | quick open; `tab` next tab, `:` line, `@`, `>` commands | | `ctrl+n`, `ctrl+s` | new untitled file, save | | `ctrl+enter` | commit | | `ctrl+g`, `ctrl+shift+o` | go to line, symbol | | `alt+F5` `shift+alt+F5` | next, previous change of the diff or file shown | | `alt+F3` `shift+alt+F3` | a file's next, previous change in the quick diff | | `F8` `shift+F8`, `ctrl+shift+m` | next, previous problem; the Problems list | | `ctrl+shift+v`, `alt+v` (in a file) | rendered Markdown, side by side | | `ctrl+alt+-` `ctrl+-` `alt+,` `super+←` | back through visited editors | | `ctrl+shift+-` `alt+.` `super+→` | forward | The empty editor area (the welcome text) focused: `n` new session, `w` new worktree, `a` add project, `3` Sessions, `ctrl+n` new file; in a split `ctrl+w` `ctrl+d` close that group. ## Sidebar lists - `↑` `↓` `j` `k`, `pgup` `pgdn`: move, a page - `g` `home`, `G` `end`: first, last row - `⏎` `space`, `→` `l`, `←` `h`: activate, unfold, fold or go to the parent - `m`, right click: context menu - `ctrl+f`: filter (`⏎` keeps it, `esc` clears); in Sessions `/` too, and `⏎` opens the row found - `1` `2` `3` `4` `6` `7` `8` `9`: Explorer, Source Control, Sessions, Search, GitHub, Databases, Customizations, Usage - `tab`: focus main - `b`, `<` `>`: hide this column, narrow or widen it - `,`, `?`: settings, help - `q`, `esc`: close pando, asking first (sessions keep running) - `ctrl+c`: close pando at once, asking first with table edits not submitted (in Explorer: copy) ## Views | View | Keys | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Explorer | `⏎` open, `n` `N` new file, folder, `R` `F2` rename, `D` `del` delete, `d` duplicate, `ctrl+x` `ctrl+c` `ctrl+v` cut, copy, paste, `s` stage, `e` `$EDITOR`, `o` system app, `O` containing folder, `F` find in folder, `c` `y` `Y` copy name, path, relative path, `.` dotfiles, `C` collapse, `r` refresh | | Source Control | `⏎` stage, unstage, `o` diff, `O` open, `d` discard, `a` `u` stage, unstage all, `U` stage untracked, `c` message, `C` commit, `A` suggest, `S` sync, publish, `B` branch or tag, `t` tree, `{` `}` repository, `r` refresh | | Sessions | `⏎` `l` switch, `/` find, `alt+↑` `alt+↓` reorder, `n` session, `w` worktree, `a` add project, `R` rename, `p` pin, `z` sleep, `x` `d` `del` kill, delete, close, `o` view options, `r` refresh | | Search | `ctrl+f` `/` `i` query, `ctrl+h` replace, `ctrl+i` include, `⏎` `o` open, `r` `R` replace in file, all, `alt+c` `alt+w` `alt+r` `alt+p` case, word, regex, preserve case, `t` tree, `ctrl+r` rerun, `x` clear, `C` collapse | | GitHub | `⏎` open, `d` pull request diff, `w` worktree (issue: start one), `o` github.com, `y` copy link, `x` mark done, `ctrl+r` refresh, `C` collapse; on an opened page `c` comment, `x` close, `M` merge, `R` ready | | Databases | `⏎` `l` open a table, unfold a source, `t` console, `n` new connection, `e` `D` edit, remove one, `c` `y` copy name, path, `r` `ctrl+r` refresh, `C` collapse; in its form `tab` `↑` `↓` move, `←` `→` change Type and Save, `ctrl+t` test, `⏎` save | | Customizations | `⏎` `l` open a file, unfold a section, `←` `h` fold or go to the section, `a` agent, `c` `y` copy name, path, `r` `ctrl+r` refresh, `C` collapse | | Usage | `⏎` new sessions start with the profile, `a` switch automatically, `r` `ctrl+r` ask again | Commit message: `⏎` commits, `shift+⏎` `alt+⏎` new line, `esc` `tab` leave, `ctrl+a` all, `home` line start, `ctrl+c` `ctrl+x` copy, cut, `↑` on the top line an older commit message, `↓` on the bottom line a newer one. Search boxes: `⏎` `↓` to the results, `tab` next box. ## Terminals - `ctrl+f`: find in the scrollback; in an app that scrolls itself, on its screen - `shift+F3`, `F3` (in the box also `⏎` `↑`, `shift+⏎` `↓`): previous (older), next match - `alt+c` `alt+w` `alt+r`: find: case, word, regex - `esc` (`ctrl+f` in the box): close find; a click on the terminal keeps the matches - `pgup` `pgdn` (`shift` too): page the scrollback; the app's when it scrolls itself (the alternate screen, or it takes the mouse) - `alt+z`: Terminal panel: fit to the content width, scroll sideways - `ctrl+click` a URL or a `path:line`: open it, in the browser or the editor ## In a file Editable files and read-only views (diff, revision, rendering): | Key | Action | | ------------------------------------ | -------------------------------------------------------- | | arrows, `shift`+arrows | move, select | | `ctrl+←` `ctrl+→` | a word back, on (`shift` selects) | | `home` `end`, `ctrl+home` `ctrl+end` | line start, end; file start, end | | `ctrl+↑` `ctrl+↓` | scroll the view, the cursor stays | | `alt+shift+→` `alt+shift+←` | expand, shrink the selection: word, line, brackets, file | | `ctrl+a`, `ctrl+c` | select all, copy the selection (or the whole file) | | `ctrl+f`, `ctrl+h` | find, replace | | `F3` `shift+F3` | next, previous match with the find box closed | | `F12`, `shift+F12`, `F2` | go to definition, references, rename symbol | | `ctrl+k` | the language server's hover for the word at the cursor | | `ctrl+shift+[` `ctrl+shift+]` | fold the block at the cursor, unfold the one it heads | | `ctrl+.` `alt+⏎` | quick fix | | `ctrl+shift+i` | format document | | `alt+z` | word wrap | | `shift+F10`, right click | menu: Stage / Unstage / Revert Selected Ranges in a diff | | `esc`, `ctrl+w` | clear the selection, else close; close | Editable only: - `⏎`, `tab`, `⌫`, `del`: type; `⏎` keeps the indent, `tab` follows the file's indentation - `(` `,`: the call's parameter hints, active parameter in bold; `esc` closes them - `ctrl+z`, `ctrl+y` `ctrl+shift+z`: undo, redo - `ctrl+x`, `ctrl+v`: cut (the line without a selection), paste - `ctrl+shift+k`, `ctrl+shift+d`: delete the line or selection - `alt+↑` `alt+↓`: move the line - `alt+shift+↑`, `alt+shift+↓` `ctrl+d`: copy the line up, down - `ctrl+/`: toggle a comment on the line or every selected line, in the language there (a `