Appearance
Getting started
Install
Paste this into a terminal on macOS or Linux:
sh
curl -fsSL https://ghosted.megasupersoft.com/install.sh | shIt 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.
| macOS | Apple silicon and Intel |
| Linux | x86_64 and arm64, any distribution |
| Windows | not yet |
Open it
sh
ghostedThe 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+bthenq) only detaches; runghostedagain to pick up where you were.ghosted server stopstops 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+bby default (like tmux):ctrl+b cnew tab,ctrl+b ?all keys,ctrl+b ssettings. - 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.