Appearance
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 restartingCopy 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 default | Why |
|---|---|---|
sidebar_start_collapsed | true | Spaces 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_right | Ghosted's status: where you are, agents waiting, running jobs, Claude usage | click one to open Spaces or Accounts |
tab_bar_right_separator | " · " | |
show_agent_labels_on_pane_borders | true | each agent's name on its pane |
agent_panel_sort | "priority" | agents that need you first |
Elsewhere
- Themes: Themes.
[agents]and[providers](which agent tool "New agent" starts, its model and provider): Agents and providers.[terminal] tmux_compat, for Claude Code agent teams and other tmux tools: tmux tools and agent teams.[ui.activity_bar](the bar on the left): The interface → The activity bar. The views' own settings live in a separate file: The interface → Settings file.