Terminal
The built-in Ghostty-backed terminal for each worktree
Supacode embeds a terminal directly in the detail pane so you can stay in the worktree while you code, test, and run agents.
Built on Ghostty
Supacode uses GhosttyKit for terminal rendering and behavior. That means terminal theming and many terminal-level shortcuts follow your Ghostty configuration instead of a parallel terminal implementation.
One terminal state per worktree
Every worktree gets its own terminal state. When you switch worktrees, Supacode restores that worktree's tabs, splits, notifications, and focused surface state inside the app.
First tab behavior
When a worktree is opened for the first time, Supacode can ensure an initial tab exists. If the worktree was just created and a setup script is configured, that first tab can launch the setup script automatically.
Core actions
From the terminal area you can:
- open a new terminal tab
- close the focused surface
- close the focused tab
- search terminal output
- split the current terminal into panes
Tabs and splits
Supacode's terminal is not limited to a single shell. Each worktree can have multiple tabs, and each tab can contain split panes.
Use terminal tabs when the commands are logically separate:
- one tab for your agent
- one tab for a dev server
- one tab for tests
- one tab for a git client such as
lazygit
The tab context menu supports:
- Close Tab
- Close Other Tabs
- Close Tabs to the Right
- Close All
Use splits when the commands belong together in the same tab.
Supacode supports split creation in multiple directions, and the split tree can be resized, equalized, or zoomed through Ghostty split actions. The split tree view also supports drag-and-drop reorganization.
Search and navigation
When a worktree terminal is focused, Supacode provides fixed search shortcuts:
| Action | Shortcut |
|---|---|
| Find | ⌘F |
| Find Next | ⌘G |
| Find Previous | ⇧⌘G |
| Hide Find Bar | ⇧⌘F |
| Use Selection for Find | ⌘E |
Notifications
Supacode can surface notifications generated from terminal activity and keep them attached to the worktree where they happened.
Unread notifications show up:
- on the worktree row in the sidebar
- in the toolbar's aggregated notifications popover
Notifications are tied to a specific terminal surface, so selecting one can jump you back to the exact place that produced it.
Theming
Appearance mode is controlled by Supacode, but terminal theming follows Ghostty. If you want the terminal palette to change with light and dark mode, configure that in your Ghostty config.