Skip to content

The palette and the overview ​

Find and go, in under a minute, with sound

The palette gets you to anything by typing a few letters. The overview shows every tab of every project at once, so you can spot what needs you and jump to it.

The palette ​

Press Ctrl+Shift+P, or leader Space. With nothing typed, it lists, in this order: Needs you, Recent (the last five commands and settings you chose), Commands, Settings, Projects, Panes and Themes.

  • Your own commands from [commands], and each mode's command from [modes], are under Commands.
  • A command shows its keys, a setting its value, and a pane its project and, if it needs you, what it says.
  • Typing narrows the list by any of your words, in any order. A word at the start of a name ranks highest, then the start of a later word, then inside a word. Of two equal fits, the one you chose more recently comes first.
  • Type pane, project, setting or theme to ask for that kind of thing.
  • Enter runs the command, goes to the project or pane, or chooses the theme.
  • Enter on a setting opens it on the settings sheet, with its list open if it has one. The palette never changes a setting to a value you haven't seen.
  • Themes listed are the built-in ones, those in your themes directory, and ghostty when Ghostty's configuration names a theme.
  • Themes are previewed. Highlight one and the whole window shows it. Enter keeps it and writes theme = "…" to the settings, leaving the rest of the file alone. Esc goes back to the theme in use. If the settings file can't be read, the theme is applied but not written, and the top bar says why.

The overview ​

Press Ctrl+Shift+Space or leader w, or choose "See every tab of every project at once" in the palette. It covers the window with each project's tabs drawn small, in their layouts: tiled panes where they sit, floating panes over them, minimized panes as a row of icons.

  • A pane shows its icon, name, a border in its state's colour, and the memory its programs hold once that's a megabyte or more.
  • Under that is the pane's screen, small and live. You can't read it, but it shows what's there (an editor, a scrolling log, a prompt) and whether it's moving.
  • A pane that's waiting, done or failed also shows what it says, readable, so you can read an agent's question without going there.
  • A project's name is followed by how many of its panes need you.
  • It opens on the tab in front, and the pane you came from says "here". Left and Right step through every tab in order, across projects. Up and Down go to the nearest tab in the row above or below.
  • In the tab the keyboard is on, a ring marks the pane Enter goes to: the first that needs you, or else the one that had the keyboard. Space moves the ring to the next pane.
  • A sleeping project is marked "asleep". Enter on one of its tabs wakes it and takes you there.
KeyDoes
EnterGo to the ringed pane
Click a pane, or a tab's titleGo to that pane, or that tab
TabShow only tabs with a pane that needs you; again for all. If none do, it says "Nothing needs you."
Esc, or a click elsewhereClose, changing nothing

Looking never resizes a pane or tells its program anything.

Good to know: the small screens are live only while the overview is open and only for panes in view, so a very busy pane's picture may lag. A dropped link shows "link lost" over a machine's panes. isc tui has an overview of layouts and words, with no small screens.

Finding a file ​

Type a file's path into the pane without typing the path. Press Ctrl+Shift+I or leader /, or choose "Find a file under the pane's directory and type its path" in the palette.

A list opens at the cursor with the files and directories under the focused pane's directory, each with an icon. With a daemon on another machine, they're that machine's files. Type a few letters, then press Enter to type the path into the pane.

  • The path Enter would type is shown dimmed at the cursor. Nothing reaches the program until you press Enter.
  • Your letters must appear in the path in order, in any case; the nearer path wins ties.
  • Up and Down choose among up to ten paths. Enter types the path and a space. Esc, or a click outside, types nothing.
  • Tab goes into the marked directory. Shift+Tab, or Backspace with nothing typed, comes back out. The path typed is still from the pane's directory.
  • The path is relative, as in src/main.rs; a directory's ends in a slash. It's quoted when a shell would read it as more than one word, as in 'my notes/to do.md'.
  • What git ignores isn't listed inside a repository. The daemon asks git once, as the list opens, and git is told to run nothing, fetch nothing and write nothing, so a repository's own config can't run a command.

Good to know: directories named target, node_modules or __pycache__ and those starting with a dot are skipped, and at most 30 000 entries are listed, nearest first. A file whose name holds a control or text-direction character isn't listed.