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.

TerminalAttachRemote

Open the TUI

ghostex
gx

Bare 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 --json

Attach 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 2

Ghostex 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

OptionWhat it does
TUI (ghostex / gx)Terminal attach UI. Best for SSH, scripting, and quick session switching from another machine.
macOS appFull 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.

Related docs