Appearance
The interface
Ghosted is mouse-first: the activity bar on the left and the views it opens beside your panes. Every view is an ordinary pane, so it can be moved, resized or closed like any other.
| View | What it's for |
|---|---|
| Spaces | Every space, tab and agent as a tree, with each agent's running commands, what it's waiting on and what's stuck. Rows with children fold (○ open, ● folded). The Inbox at the top collects agents that need you, finished and failed work, sorted into folders |
| Explorer | The project's files; click one to open it in the Editor |
| Editor | Opens the file in your own editor ($VISUAL, $EDITOR, or nano) in a pane beside your work |
| Git Graph | Branches and commits as a graph, with diffs |
| Merge Queue | Branches waiting to land, in order |
| Agents | Every agent on one map (each with its status, its subagents round it and the files it touched, grouped by workspace; click one for its own map, details, chat and terminal), or a timeline of what each was doing |
| Arrange Panes | Drag the tab's panes into place: drop on an edge to dock, in the middle to swap. Running programs keep running |
| Machines | Your saved machines and the other computers on your tailnet; Connect sets one up. See Remote machines |
| Usage | Every Claude account's limits, extra usage and this week's breakdown, with Log in, Usage page and Billing buttons. From 1.0.5 also adds accounts and moves agents between them: see Claude accounts |
| All Actions | Every action of every plugin, searchable and clickable |
| Settings | Every option with a button, in groups with a search box: the look, notifications, sound, the terminal, the mouse, sessions, worktrees, updates, agents and providers, accounts, agent integrations, the bar, keys and the background server. See Settings (1.0.7) |
Right-click almost anything for what you can do with it.
Settings file
The bar and Accounts options in Settings are saved to ~/.config/ghosted/plugins/config/studio/config.toml (studio is the interface's internal name), and edits to the file show at once; the rest go to Ghosted's own config.toml. Settings → Server → Edit the bar and panels' file… opens it. A value Ghosted can't read falls back to its default (Settings says so at the bottom); the rest of the file still applies.
| Key | Default | In Settings |
|---|---|---|
explorer_width | 32 | Spaces / Explorer width |
auto_dock | true | Spaces in every tab (Bar in every tab with the old bar, below) |
stop_stuck_after | 0 (never), in minutes | Stop stuck commands after |
auto_switch | false | Change account at a limit by itself; off: ask first (1.0.5) |
auto_switch_pinned | false | Move off a workspace's own account too (1.0.5) |
switch_at_percent | 95, 50–100 in steps of 5 | Switch accounts at; 100 waits for the limit itself |
editor | $VISUAL, $EDITOR, then nano | not in Settings |
[[accounts]] | ~/.claude plus every ~/.claude-accounts/<name> | not in Settings; with it set, Usage's + Add is hidden |
The activity bar
The activity bar is drawn by Ghosted itself and set in Ghosted's own config.toml:
toml
[ui.activity_bar]
enabled = true # false: the interface docks its own bar pane in each tab instead
width = 4 # columns, 2–12
[[ui.activity_bar.buttons]] # replaces the built-in buttons
icon = "" # a Nerd Font character
title = "Git Graph"
action = "studio.graph" # <plugin id>.<action>
group = "top" # or "bottom"With enabled = false, the interface's own bar pane comes back, and these keys in the settings file above shape it (they show in Settings then):
| Key | Default | In Settings |
|---|---|---|
narrow_width | 6 | Icon-only bar width |
wide_width | 20 | Labelled bar width |
icon_size | 0.6 | Icon size |
icon_stroke | 1.25 | Icon line thickness |
[[buttons]] | the built-in set | not in Settings; replaces that bar's buttons |
A button for that bar looks like this:
toml
[[buttons]]
icon = "" # a Nerd Font character, used when there's no SVG
svg = "git-graph" # optional: an icon name or a path to an .svg
title = "Git Graph"
plugin = "studio" # the built-in views
action = "graph"
group = "top" # or "bottom"This file's auto_switch (moving agents between Claude accounts) is not [theme] auto_switch in Ghosted's own config.toml (following your terminal's light or dark mode).