Appearance
Settings
One place for Ghosted's options, with a button for each. (From 1.0.7; before that the window had its own smaller Settings.)
Open it with Settings at the bottom of the activity bar, Settings in the window's menu, or ctrl+b s. It opens beside your work, like the other views.
- Groups are listed down the left. In a narrow pane they're a ◀ name ▾ ▶ picker instead: the arrows step through them, the name opens the full list.
- Search (the box at the top, or
/) finds a setting in any group by its name or description. - On / off switches flip with a click; − / + step through the choices; Edit lets you type a value (Enter saves, Esc cancels, an empty value goes back to the default).
- Most changes apply at once. The few that don't say so in their description, and Settings tells you again when you change one.
Everything is saved in Ghosted's config.toml (your comments and the rest of the file are kept), except the bar and Accounts options, which live in the settings file. Every key below can also be typed into the file by hand: see Configuration.
The groups
Appearance
| Setting | Key | Takes effect |
|---|---|---|
| Theme (click one; ↶ Back to … undoes) | [theme] name | at once |
| Accent colour | [ui] accent | at once |
| Agent status marks (dots or symbols) | [ui] status_indicators | at once |
| Pane borders (when split, always, off) | [ui] pane_borders | at once |
| Border around the panes | [ui] pane_outer_borders | at once |
| Gaps between panes | [ui] pane_gaps | at once |
| Scrollbars | [ui] pane_scrollbars | at once |
| Agent names on borders | [ui] show_agent_labels_on_pane_borders | at once |
| Fade other panes | [ui] dim_unfocused_panes | at once |
| Tab bar (top or bottom) | [ui] tab_bar_position | at once |
| Hide the tab bar with one tab | [ui] hide_tab_bar_when_single_tab | at once |
| Agent list order (needing you first, or by space) | [ui] agent_panel_sort | at once |
| Built-in sidebar width | [ui] sidebar_width | at once |
| Sidebar starts folded | [ui] sidebar_start_collapsed | windows you open next |
Notifications
What may interrupt you and how: see Notifications.
Sound
| Setting | Key | Takes effect |
|---|---|---|
| Sounds | [ui.sound] enabled | at once |
| "Done" sound (an mp3 file) | [ui.sound] done_path | at once |
| "Needs you" sound (an mp3 file) | [ui.sound] request_path | at once |
| One sound for both | [ui.sound] path | at once |
| Per agent: as above, on or off | [ui.sound.agents] claude, codex… | at once |
Terminal
| Setting | Key | Takes effect |
|---|---|---|
| Shell | [terminal] default_shell | new panes |
| Start the shell as (login or not) | [terminal] shell_mode | new panes |
| New panes open in | [terminal] new_cwd | new panes |
| tmux stand-in (more) | [terminal] tmux_compat | new panes |
| Images in panes | [terminal] kitty_graphics | after a restart |
| Scrollback kept | [advanced] scrollback_limit_bytes | new panes |
| Stop stuck commands after | stop_stuck_after (settings file) | at once |
Mouse & copying
| Setting | Key | Takes effect |
|---|---|---|
| Ghosted uses the mouse | [ui] mouse_capture | at once |
| Copy when you select | [ui] copy_on_select | at once |
| Lines per wheel step | [ui] mouse_scroll_lines | at once |
| Ask before closing | [ui] confirm_close | at once |
| Name new tabs | [ui] prompt_new_tab_name | at once |
| Name new workspaces | [ui] prompt_new_workspace_name | at once |
Sessions
| Setting | Key | Takes effect |
|---|---|---|
| Resume agents | [session] resume_agents_on_restore | the next time Ghosted starts |
| Wait between agents | [session] startup_per_agent_delay_ms | after a restart |
Worktrees, Updates
| Setting | Key | Takes effect |
|---|---|---|
| Worktree folder | [worktrees] directory | at once |
| Look for new versions | [update] version_check | at once |
Agents & providers
Which agent New agent starts, each agent tool on or off (with whether it's installed and its version), and the provider Claude Code, Codex, Gemini and Qwen Code use. Models, arguments and named providers are set in config.toml. See Agents and providers.
Accounts
Changing account at a limit by itself, and moving off a workspace's own account: see Claude accounts.
Integrations
Each agent Ghosted knows, whether its integration is installed, and an Install or Update button; Install all recommended does every one that's missing or out of date. (Agent integrations in All Actions opens Settings here.)
Bar & side panel
The Spaces / Explorer width and keeping Spaces in every tab: see The interface.
Keybindings
Every key, read-only for now. Edit config.toml… opens the file to change them ([keys], see Configuration).
Server
Which version is running, Switch to a newly installed one or Restart (your shells and agents keep running), Stop server, and buttons to open the two settings files.
Remote machines and Windows
The window asks the machine it's showing to open Settings. When that machine's Ghosted is older, or on Windows, the window opens its own, smaller Settings instead (theme, status marks, sound, how notifications show, integrations).