Skip to content

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.

ViewWhat it's for
SpacesEvery 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
ExplorerThe project's files; click one to open it in the Editor
EditorOpens the file in your own editor ($VISUAL, $EDITOR, or nano) in a pane beside your work
Git GraphBranches and commits as a graph, with diffs
Merge QueueBranches waiting to land, in order
AgentsEvery 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 PanesDrag the tab's panes into place: drop on an edge to dock, in the middle to swap. Running programs keep running
MachinesYour saved machines and the other computers on your tailnet; Connect sets one up. See Remote machines
UsageEvery 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 ActionsEvery action of every plugin, searchable and clickable
SettingsEvery 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.

KeyDefaultIn Settings
explorer_width32Spaces / Explorer width
auto_docktrueSpaces in every tab (Bar in every tab with the old bar, below)
stop_stuck_after0 (never), in minutesStop stuck commands after
auto_switchfalseChange account at a limit by itself; off: ask first (1.0.5)
auto_switch_pinnedfalseMove off a workspace's own account too (1.0.5)
switch_at_percent95, 50–100 in steps of 5Switch accounts at; 100 waits for the limit itself
editor$VISUAL, $EDITOR, then nanonot 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):

KeyDefaultIn Settings
narrow_width6Icon-only bar width
wide_width20Labelled bar width
icon_size0.6Icon size
icon_stroke1.25Icon line thickness
[[buttons]]the built-in setnot 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).

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