Skip to content

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 ​

SettingKeyTakes effect
Theme (click one; ↶ Back to … undoes)[theme] nameat once
Accent colour[ui] accentat once
Agent status marks (dots or symbols)[ui] status_indicatorsat once
Pane borders (when split, always, off)[ui] pane_bordersat once
Border around the panes[ui] pane_outer_bordersat once
Gaps between panes[ui] pane_gapsat once
Scrollbars[ui] pane_scrollbarsat once
Agent names on borders[ui] show_agent_labels_on_pane_bordersat once
Fade other panes[ui] dim_unfocused_panesat once
Tab bar (top or bottom)[ui] tab_bar_positionat once
Hide the tab bar with one tab[ui] hide_tab_bar_when_single_tabat once
Agent list order (needing you first, or by space)[ui] agent_panel_sortat once
Built-in sidebar width[ui] sidebar_widthat once
Sidebar starts folded[ui] sidebar_start_collapsedwindows you open next

Notifications ​

What may interrupt you and how: see Notifications.

Sound ​

SettingKeyTakes effect
Sounds[ui.sound] enabledat once
"Done" sound (an mp3 file)[ui.sound] done_pathat once
"Needs you" sound (an mp3 file)[ui.sound] request_pathat once
One sound for both[ui.sound] pathat once
Per agent: as above, on or off[ui.sound.agents] claude, codex…at once

Terminal ​

SettingKeyTakes effect
Shell[terminal] default_shellnew panes
Start the shell as (login or not)[terminal] shell_modenew panes
New panes open in[terminal] new_cwdnew panes
tmux stand-in (more)[terminal] tmux_compatnew panes
Images in panes[terminal] kitty_graphicsafter a restart
Scrollback kept[advanced] scrollback_limit_bytesnew panes
Stop stuck commands afterstop_stuck_after (settings file)at once

Mouse & copying ​

SettingKeyTakes effect
Ghosted uses the mouse[ui] mouse_captureat once
Copy when you select[ui] copy_on_selectat once
Lines per wheel step[ui] mouse_scroll_linesat once
Ask before closing[ui] confirm_closeat once
Name new tabs[ui] prompt_new_tab_nameat once
Name new workspaces[ui] prompt_new_workspace_nameat once

Sessions ​

SettingKeyTakes effect
Resume agents[session] resume_agents_on_restorethe next time Ghosted starts
Wait between agents[session] startup_per_agent_delay_msafter a restart

Worktrees, Updates ​

SettingKeyTakes effect
Worktree folder[worktrees] directoryat once
Look for new versions[update] version_checkat 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).

Made by Megasupersoft. Free to use; not open source. Built on herdr (Apache-2.0).