The palette and the overview

The palette

Press Ctrl+Shift+P, or leader Space. The palette lists, in this order: panes that need you; every command with its key; projects; the other panes; themes.

• Typing narrows the list by any of the words you type, in any order.
• Enter runs the command, goes to the project or pane, or chooses the theme.
• The themes listed are the built-in ones, the ones in your own themes directory, and ghostty when Ghostty's configuration names a theme.
• Themes are previewed. Highlight a theme and the whole window shows it straight away. Enter keeps it and writes theme = "…" to the settings, without touching the rest of the file, comments included. Escape goes back to the theme in use.
• If the settings file can't be read as settings, the theme is applied but not written, and the top bar says why.
• Copy, paste, select-all and find aren't listed. They act on a terminal that has the keyboard, and the palette has taken the keyboard.
• The theme is the only setting the palette changes. Change other settings in the file.

The overview

Press Ctrl+Shift+Space or leader w, or choose "See every tab of every project at once" in the palette.

The overview covers the whole window. It shows each project's name and, under it, each of the project's tabs drawn small, in its layout. Tiled panes are where they are in the tab, floating panes lie over them, and minimized panes are a row of icons underneath.

• A pane shows its icon, its name, and a border in the colour of its state.
• A pane that's waiting, done or failed also shows what it says about that, so you can read an agent's question without going there.
• A project's name is followed by the number of its panes that need you.
• The overview opens with the tab in front marked "here". Left and Right go through every tab in order, across projects. Up and Down go to the row above or below, which is the next project's row when the project has one row. All four stop at the ends.
• Press Enter, or click a tab, to go there. Escape, or a click anywhere else, closes the overview and changes nothing.
• It doesn't resize anything and doesn't attach to any pane. It's drawn from what the daemon already reports about each pane.
• It doesn't show what's on the panes' screens.

Finding a file

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

A small list opens at the terminal's cursor. It shows the files and directories under the focused pane's directory, each with an icon for its kind. Type a few letters of the one you want, then press Enter to type its path into the pane.

• The path that Enter would type is shown at the cursor, dimmed, as you move through the list. The window draws it over the terminal. Nothing is sent to the program until you press Enter.
• The letters must appear in the path in the order you typed them, in any case. Letters count for more when they're in the file's own name, at the start of a word, or next to one another. When two paths match equally, the nearer one comes first.
• Up and Down choose among the paths listed, ten at most. Enter types the path, followed by a space. Escape, or a click outside the list, types nothing.
• The path is relative to the pane's directory, as in src/main.rs. A directory's path ends in a slash. The path is quoted when it contains anything a shell wouldn't read as one word, as in 'my notes/to do.md'.
• The path is typed as a paste, so it works in a shell, an editor's command line or an agent's prompt: anything that takes typing.
• Directories named target, node_modules or __pycache__ are skipped, and so are directories whose names begin with a dot, such as .git. Files whose names begin with a dot are listed. Links to directories aren't followed.
• At most 30 000 files and directories are read. In a directory with more, such as a home directory, only the nearest 30 000 can be found.
• The directory is where the pane's shell is, not where a program running in the shell has gone.
• The list opens under the cursor's row, or above it when there's no room underneath. Anything .gitignore names is listed like anything else.