All pages
Docs · Other surfaces
Quick Terminal
Availability: macOS · Linux (Wayland only) · Windows.
On Linux this needs gtk4-layer-shell, which is a Wayland protocol. Under
X11 the Quick Terminal does not open and the app says so in a warning at
startup — that is upstream Ghostty's state, not something the fork removed.
On Windows it is an always-on-top undecorated window positioned against the
edge you configured; that path is written but has never been run, so treat a
misbehaving Quick Terminal there as a bug rather than as your configuration.
The Quick Terminal is a floating HUD overlay you can summon from
anywhere with a global shortcut. It ships unbound — give
toggle_quick_terminal a chord in Settings → Keybindings, or add a
global: binding to your config so it works from any app:
keybind = global:ctrl+cmd+t=toggle_quick_terminal
Hit the chord again to dismiss. It's also in the menu as View → Quick Terminal.
Use it for:
- "Just run this one command" without disturbing your window layout
- A scratch shell on a different Space
- Pasting in a command from another app without alt-tabbing back to TRMNLY
Behavior
- It's a single pane — no tab bar, and no splits (grid layouts skip it too).
- It runs your regular shell and config, but it isn't tied to the active project.
- It rides above your other windows (panel-style window level).
- Dismissing it doesn't kill the running process; reopening shows the same shell with whatever scrollback is there.
Position
The Quick Terminal can dock to:
- Top (default) — slides down from the menu bar
- Bottom
- Center — a free-floating panel
- Left / Right edges
Configure with the quick-terminal-position key in your Ghostty config:
quick-terminal-position = top
quick-terminal-size = 60%
Animations match the docked side. Resizing it manually re-centers if it's
in top/bottom/center, and re-pins vertically if it's on a side edge.
When to use it vs a new window
- New window (
⌘N) — work that will outlive a single command. - New tab (
⌘T) — work tied to a project. - Quick Terminal — interruptions, one-shot commands, scratch space.
If a Quick Terminal command turns into real work, dismiss the HUD and re-run the command in a tab where it can keep scrollback alongside related work.