TUI mode
Running ghostex or gx with no subcommand opens the Ghostex terminal TUI — a lightweight attach UI for switching projects and sessions without the full macOS app. Use it from SSH on another machine to reach live agent sessions.
Open the TUI
ghostex
gxBare ghostex or gx opens the full TUI. This is different from gx attach or gx a with no selector, which opens only the fast single-session attach picker.
What the TUI shows
- The attached session terminal, with a top switch button for project/session switching.
- Projects and sessions in macOS sidebar order, including the active Last Active sort mode.
- Each project prints its path once as the section header, then compact session rows without field labels.
- Attach goes through the existing zmx path (or tmux/zellij when configured).
Session switching
Use the switcher to move between Ghostex projects and sessions. Direct attach remains available without opening the full TUI:
gx sessions
gx a 1
gx attach "project:session title"Flat session list
For scripting or quick scanning, list sessions without project grouping:
gx sessions --ungrouped
gx s -u --jsonAttach from SSH
Typical remote workflow over Tailscale SSH:
ssh user@mac-tailscale-host
gx sessions
gx a 2
# Wake a sleeping session before attach
gx wake 2
gx a 2Ghostex uses zmx by default for new installs. The TUI and attach commands can start missing zmx providers through gxserver before launching the interactive attach.
TUI vs desktop app
| Option | What it does |
|---|---|
TUI (ghostex / gx) | Terminal attach UI. Best for SSH, scripting, and quick session switching from another machine. |
macOS app | Full ADE: sidebar, browser panes, code editor, notifications, pets, and GUI agent panes. |
gx attach (no args) | Lightweight picker — not the full TUI. |
Prompt editor over SSH
ghostex attach --prompt-editor monaco advertises Monaco prompt-editor capability over SSH. Android, iOS, TUI, and plain SSH attaches omit this flag, so gxserver returns zmx attach commands without Monaco capability.