core-agent-tui

Overview ¶

Command core-agent-tui is the operator-facing TUI consumer of attach-mode — the remote client for an agent running elsewhere (on a workstation, in a K8s pod, or as a peer-registered fleet member). For local-spawn use, run `core-agent` directly — its in-process TUI is the default when stdin is a terminal.

Architecture: a thin shell around go-steer/core-tui. URL parsing + optional session-picker run pre-TUI; once a session is resolved the shell constructs an internal/coretuiremote adapter and hands it to coretui.Run. The adapter wraps internal/attachclient so all remote-attach round-trips go through the same protocol the in-process core-agent surfaces.

Usage:

core-agent-tui                       # bare: prompt for URL
core-agent-tui <url> [--token=ENV]   # attach immediately

URL forms (same as `core-agent attach`):

http(s)://host:port                              # hub: enumerates sessions
http(s)://host:port/sessions/<sid>               # direct-jump
http(s)://host:port/sessions/<app>/<sid>         # qualified direct-jump
unix:///path/to/socket                           # Unix socket hub
unix:///path/to/socket/sessions/<sid>            # Unix socket direct-jump