Skip to content

Configuration ​

Ghosted works without a config file. When you want one, it's ~/.config/ghosted/config.toml (ghosted --help prints the path; set GHOSTED_CONFIG_PATH to use another).

sh
ghosted --default-config        # print every option, commented out
ghosted config check            # find mistakes
ghosted server reload-config    # apply edits without restarting

Copy the options you want from --default-config into your file. Most of them also have a button in Settings, which writes the file for you.

Some changes, like the sidebar's starting state, only show the next time Ghosted starts.

Ghosted's own defaults ​

Ghosted starts from its own look, under whatever your file sets. Anything you set wins:

Key under [ui]Ghosted's defaultWhy
sidebar_start_collapsedtrueSpaces takes the sidebar's place
sidebar_collapsed_mode"hidden"
tab_bar_position"bottom"tabs at the bottom, with Ghosted's status on the right
tab_bar_rightGhosted's status: where you are, agents waiting, running jobs, Claude usageclick one to open Spaces or Accounts
tab_bar_right_separator" · "
show_agent_labels_on_pane_borderstrueeach agent's name on its pane
agent_panel_sort"priority"agents that need you first

Elsewhere ​

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