squad-station-2

Squad Station

Message routing and orchestration for AI agent squads — stateless CLI, no daemon.

Squad Station routes messages between an AI orchestrator and N agents running in tmux sessions. Provider-agnostic: works with Claude Code, Gemini CLI, or any AI tool.

Install

npx squad-station-2@latest install --tui

The interactive TUI guides you through setup — press y to launch the init wizard, which generates squad.yml and starts your squad automatically.

Quickstart

Step 1 — Install and follow the TUI wizard (see above)

Step 2 — Open the monitor:

squad-station open

Step 3 — Send a task:

squad-station send my-app-claude-code-backend --body "Implement the /api/health endpoint"

Step 4 — Monitor your fleet:

squad-station monitor   # Interactive TUI — live agent pane viewer (recommended)
squad-station fleet     # Fleet overview — tasks, busy duration, alignment per agent
squad-station browser   # Browser dashboard — React Flow graph visualization
squad-station open      # Attach to tmux tiled view of all agent panes
squad-station ui        # TUI dashboard
squad-station status    # Text overview
squad-station list      # Message queue

Commands

Command	Description
squad-station init	Launch squad from squad.yml — creates DB, tmux sessions, hooks
squad-station init --tui	Interactive TUI wizard — generate squad.yml, then launch
squad-station send <agent> --body "<task>"	Send a task to an agent
squad-station signal $TMUX_PANE	Signal agent completed its task
squad-station monitor	Interactive TUI — live agent pane viewer
squad-station fleet	Fleet status overview — tasks, busy duration, alignment
squad-station browser	Browser dashboard — React Flow graph with live WebSocket updates
squad-station clone <agent>	Clone an agent with auto-incremented naming
squad-station open	Attach to tmux monitor session
squad-station list	List messages
squad-station agents	List agents with live status
squad-station status	Project and agent summary
squad-station view	Open tmux tiled view of all agents
squad-station ui	Interactive TUI dashboard
squad-station close	Kill all squad tmux sessions
squad-station reset	Kill sessions, delete DB, relaunch

Requirements

• macOS or Linux
• tmux

License

MIT