scorpiox-tmux shell

linux-x64 linux-arm64 macos-arm64 windows-x64

Mission Control TUI for managing AI agents in tmux sessions. List, peek, watch, kill, and resume headless agent sessions with full scrollback capture.

⚙️ Flags & Options (17)

Flag Short Description Takes Value
--list List all tmux sessions No
--kill Kill a session Yes
--peek Capture visible pane content Yes
--watch Capture full pane with scrollback history Yes
--projects List remote projects No
--resume Attach to session (interactive) Yes
--help Show usage No
--cmd Run arbitrary command (with --new) Yes
--env Set env var KEY=VALUE (repeatable, with --new) Yes
--output-json Machine-readable JSON output No
--wait Block until command finishes (with --cmd) Yes
--timeout Max session runtime (with --cmd) Yes
--model -m Set AI model for the session Yes
--mode Set session mode Yes
--branch Git branch for the project Yes
--name Custom session name Yes
--on-exit Action to take when session exits Yes

💡 Usage Examples

List all active tmux sessions
$ scorpiox-tmux --list
SESSION PID STATUS UPTIME
agent-opus-abc123 4521 running 2h 14m
agent-sonnet-def456 4802 running 45m
build-task-789 5103 idle 12m
List sessions as machine-readable JSON
$ scorpiox-tmux --list --output-json
# Returns JSON array of session objects for scripting
[{"name":"agent-opus-abc123","pid":4521,"status":"running"}]
Peek at the visible pane output of a session
$ scorpiox-tmux --peek agent-opus-abc123
# Shows the last visible lines of the session pane
# Useful for quick status checks without attaching
Watch a session with full scrollback history
$ scorpiox-tmux --watch agent-opus-abc123
# Captures the full pane including scrollback buffer
# Pipe to a file for logging:
$ scorpiox-tmux --watch agent-opus-abc123 > /tmp/session.log
Resume (attach to) an existing session interactively
$ scorpiox-tmux --resume agent-opus-abc123
# Attaches to the session — Ctrl+B, D to detach again
Kill a specific session
$ scorpiox-tmux --kill agent-opus-abc123
# Terminates the tmux session and all processes inside
Run a command in a new tmux session
$ scorpiox-tmux --cmd "scorpiox --model opus --print" \
    --name my-task \
    --env ANTHROPIC_API_KEY=sk-ant-...
# Creates a new tmux session named "my-task" running the command
Run a command and wait for it to finish
$ scorpiox-tmux --cmd "make build" \
    --wait true \
    --timeout 300
# Blocks until "make build" completes or 300s timeout
Launch an AI agent session with model and branch
$ scorpiox-tmux --cmd "scorpiox --print" \
    --model opus \
    --branch feature/new-api \
    --name api-refactor \
    --on-exit notify
# Starts an opus agent on the feature branch, notifies on exit
List remote projects available for agents
$ scorpiox-tmux --projects
PROJECT BRANCH LAST ACTIVE
scorpiox-code-website main 2h ago
scorpiox-server dev 5h ago
agent-toolkit main 1d ago

📦 Source & Build Info

Source File
scorpiox/scorpiox-tmux.c
Lines of Code
3,135
Dependencies
libsxterm, libsxutil