CLI Reference

ensemble CLI

# Run via tsx
npx tsx cli/ensemble.ts <command>

# Or if linked
ensemble <command>

Commands

Command	Description
status	Check server health
teams / ls	List all teams
monitor [teamId]	Open TUI monitor
monitor --latest	Monitor most recent team
steer <teamId> "msg"	Send steering message to team
help	Show help

Examples

# Check server
ensemble status

# List active teams
ensemble teams

# Watch the latest team
ensemble monitor --latest

# Redirect a team's focus
ensemble steer abc-123 "Stop the current approach and focus on testing"

---

TUI Monitor

The terminal monitor (cli/monitor.ts) provides a real-time view of agent collaboration.

Keybindings

Key	Action
s	Steer entire team (opens input)
1-4	Steer specific agent by index
j / k or ↓ / ↑	Scroll message history
d	Disband team
q	Quit monitor
ESC	Cancel input

Idle detection

After 60 seconds of no activity combined with completion signals, the monitor shows an action menu:

• Show summary
• Let team continue working
• Steer with new goal
• Disband team

---

npm scripts

npm run dev       # Start server (development)
npm run start     # Start server (production)
npm run build     # TypeScript typecheck (no emit)
npm run lint      # ESLint
npm run monitor   # Open TUI monitor for latest team
npm run cli       # Run ensemble CLI