The palette and the overview
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,settingorthemeto ask for that kind of thing. Enterruns the command, goes to the project or pane, or chooses the theme.Enteron 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
themesdirectory, andghosttywhen Ghostty's configuration names a theme. - Themes are previewed. Highlight one and the whole window shows it.
Enterkeeps it and writestheme = "…"to the settings, leaving the rest of the file alone.Escgoes 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".
LeftandRightstep through every tab in order, across projects.UpandDowngo to the nearest tab in the row above or below. - In the tab the keyboard is on, a ring marks the pane
Entergoes to: the first that needs you, or else the one that had the keyboard.Spacemoves the ring to the next pane. - A sleeping project is marked "asleep".
Enteron one of its tabs wakes it and takes you there.
| Key | Does |
|---|---|
Enter | Go to the ringed pane |
| Click a pane, or a tab's title | Go to that pane, or that tab |
Tab | Show only tabs with a pane that needs you; again for all. If none do, it says "Nothing needs you." |
Esc, or a click elsewhere | Close, 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
Enterwould type is shown dimmed at the cursor. Nothing reaches the program until you pressEnter. - Your letters must appear in the path in order, in any case; the nearer path wins ties.
UpandDownchoose among up to ten paths.Entertypes the path and a space.Esc, or a click outside, types nothing.Tabgoes into the marked directory.Shift+Tab, orBackspacewith 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.