Session gateway server and CLI client for ScorpioX Code. Manages remote session connections, daemon mode hosting, event streaming, and client registration for distributed agent workflows.
| Flag | Short | Description | Takes Value |
|---|---|---|---|
--daemon |
-d |
Run as a background daemon on the specified port or socket | Yes |
--event |
— | Emit session events to stdout in real-time | No |
--follow |
-f |
Follow and stream session output continuously | No |
--help |
-h |
Display help information and exit | No |
--port |
— | Specify the TCP port for the gateway server to listen on | Yes |
--register |
— | Register this client with the gateway server for session routing | No |
--version |
-v |
Display version information and exit | No |
# Start the session gateway on port 8800 $ scorpiox-host --daemon start --port 8800 scorpiox-host: daemon started on port 8800 (pid 41023) # Start on default port $ scorpiox-host -d start scorpiox-host: daemon started on port 7700 (pid 41050)
# Register this machine with the gateway server $ scorpiox-host --register registered client: dev-machine-01 (id: c7a3f1b2) gateway: 192.168.1.10:8800 status: connected # Register and immediately follow output $ scorpiox-host --register --follow registered client: dev-machine-01 (id: c7a3f1b2) [session:a4c1] agent started — task: refactor auth module [session:a4c1] tool: Bash — running lint checks... [session:a4c1] step 3/5 complete
# Watch real-time session events from all connected agents $ scorpiox-host --event --follow [14:32:01] session:b7e2 created — agent: codex-review [14:32:03] session:b7e2 tool_call: ReadDocs url=https://docs.example.com [14:32:08] session:b7e2 tool_result: 2847 bytes received [14:32:10] session:a4c1 completed — 5 steps, 42s elapsed # Stream events (one-shot, no follow) $ scorpiox-host --event [snapshot] 3 active sessions, 2 clients registered
# Check daemon status $ scorpiox-host -d status scorpiox-host daemon: running (pid 41023) uptime: 2h 14m port: 8800 clients: 3 active sessions: 7 # Stop the daemon $ scorpiox-host -d stop scorpiox-host: daemon stopped (pid 41023) # Show version $ scorpiox-host --version scorpiox-host 1.0.0 (built from scorpiox/scorpiox-host.c, 1877 lines)
scorpiox/scorpiox-host.clibsxutil