Skip to content

Getting started ​

Install ​

Paste this into a terminal on macOS or Linux:

sh
curl -fsSL https://ghosted.megasupersoft.com/install.sh | sh

It downloads the build for your machine, checks it, and puts ghosted in ~/.local/bin. If that folder isn't on your PATH, the installer says what to add to your shell config.

macOSApple silicon and Intel
Linuxx86_64 and arm64, any distribution
Windowsnot yet

Open it ​

sh
ghosted

The first time, Ghosted starts its background server and opens a workspace in your current folder. The activity bar is on the left: click an icon to open that view beside your panes.

The basics ​

  • Everything keeps running. Closing the window (or ctrl+b then q) only detaches; run ghosted again to pick up where you were. ghosted server stop stops the server and its panes.
  • Split, move and resize with the mouse. Drag a pane by the label on its top border: onto another pane's edge to sit beside it, onto its middle to swap, onto a tab to move it there. Drag a border to resize.
  • Keys use a prefix, ctrl+b by default (like tmux): ctrl+b c new tab, ctrl+b ? all keys, ctrl+b s settings.
  • Agents are found for you. Start Claude Code, Codex or OpenCode in any pane and Spaces shows its state; when one needs you, it lands in the Inbox.

Update ​

Ghosted checks for a new version in the background and shows a notice when one is out. To install it:

sh
ghosted update --handoff

--handoff moves your running panes onto the new version without stopping them. Without it, the background server keeps running the old version until it stops; the next time you open Ghosted it offers to switch it over (Settings → Server does the same). Changes to the window itself show once you close it and run ghosted again.

Don't want the notice? Set version_check = false under [update] in config.toml.

Uninstall ​

sh
ghosted server stop
rm ~/.local/bin/ghosted
rm -rf ~/.config/ghosted ~/.local/state/ghosted   # settings and saved sessions
rm -rf ~/.claude-accounts   # Claude accounts Ghosted added (1.0.5), if any

~/.claude is Claude Code's own and stays.

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