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.