/fleet
Fleet orchestration — manage coding agents (Claude Code, Copilot, Amplifier) running across multiple Azure VMs via azlin.
Invoke as /fleet <command> or just describe what you want and Claude will pick the right command.
All Commands
Status & Monitoring
| Command |
What it does |
fleet status |
Quick text overview of all VMs and sessions |
fleet scout |
Discover, adopt, dry-run reason, show report |
fleet snapshot |
Point-in-time capture of all managed sessions |
fleet watch <vm> <session> |
Live snapshot of a single session |
fleet observe <vm> |
Observe sessions with pattern classification |
fleet tui |
Interactive Textual TUI dashboard |
Admiral Control
| Command |
What it does |
fleet advance |
LIVE — reason and execute actions on sessions |
fleet dry-run |
Show what the admiral would do (no action) |
fleet run-once |
Single PERCEIVE->REASON->ACT cycle |
fleet start |
Run autonomous admiral loop |
Session Management
| Command |
What it does |
fleet adopt <vm> |
Bring existing tmux sessions under management |
fleet auth <vm> |
Propagate auth tokens (GitHub, Azure, Claude) |
Task Management
| Command |
What it does |
fleet add-task "prompt" |
Queue work for the fleet |
fleet queue |
Show task queue |
fleet dashboard |
Project-level tracking |
fleet report |
Generate fleet status report |
Projects & Knowledge
| Command |
What it does |
fleet project add/list/remove |
Manage fleet projects |
fleet project add-issue <proj> <num> |
Track a GitHub issue as a project objective |
fleet project track-issue <proj> |
Sync objectives from GitHub issues by label |
fleet graph |
Fleet knowledge graph summary |
Co-Pilot
| Command |
What it does |
fleet copilot-status |
Show copilot lock/goal state |
fleet copilot-log |
Show copilot decision history |
Quick Reference
| User says |
Command |
| "What are my agents doing?" |
fleet scout |
| "Show me the fleet" |
fleet status |
| "Send next steps to all sessions" |
fleet advance |
| "Advance without confirmation" |
fleet advance --force |
| "Watch what dev/cybergym is doing" |
fleet watch dev cybergym |
| "Add auth to the new VM" |
fleet auth <vm> |
| "Queue this task for the fleet" |
fleet add-task "prompt" |
| "Track issue #42 for myapp" |
fleet project add-issue myapp 42 |
| "Sync objectives from GitHub" |
fleet project track-issue myapp |
| "Open the dashboard" |
fleet tui |
Key Options
fleet scout [--session vm:session] [--vm VM] [--skip-adopt] [--incremental] [--save PATH]
fleet advance [--session vm:session] [--vm VM] [--force] [--save PATH]
fleet dry-run [--vm VM ...] [--backend auto|anthropic|copilot|litellm]
fleet adopt <vm> [--sessions s1 s2]
fleet watch <vm> <session> [--lines 30]
fleet auth <vm> [--services github azure claude]
fleet add-task "prompt" [--priority high] [--repo URL]
fleet start [--interval 300] [--max-cycles 10]
Environment
| Variable |
Required for |
AZLIN_PATH |
All commands (auto-detected if azlin on PATH) |
ANTHROPIC_API_KEY |
scout, advance, dry-run, run-once, start |
Admiral Configuration
- Model: Claude Opus 4.6 (
claude-opus-4-6)
- Max output tokens: 128,000 (reasoning JSON)
- Context gathered per session: full tmux scrollback + first 50 & last 200 transcript messages
- Safety: 57 dangerous-input patterns blocked (with safe allow-list), confidence thresholds (60% send_input, 80% restart), --confirm default on advance
- Docs:
docs/fleet-orchestration/ADMIRAL_REASONING.md
Status Icons
| Icon |
Status |
Meaning |
[~] |
thinking |
Agent is actively processing |
[>] |
running |
Agent producing output |
[.] |
idle |
Agent at prompt, waiting for direction |
[X] |
shell (dead agent) |
No agent detected in this session |
[Z] |
suspended |
Agent backgrounded but alive |
[!] |
error |
Error detected in session output |
[+] |
completed |
Agent finished its task |
[?] |
waiting input |
Agent asked a question, awaiting response |
Performance & Architecture
- Sequential VM polling: Session discovery from
azlin list (no SSH). Pane capture via sequential SSH
- Cached SSH output: Scout caches Phase 1 tmux captures for Phase 3 reasoning (no double-poll)
- Incremental scout:
--incremental flag skips unchanged sessions using ~/.amplihack/fleet/last_scout.json
- Bastion tunnel reuse: Reuses existing SSH tunnels via
get_existing_tunnels() instead of creating new ones
- PR URL detection: Uses
gh pr list on remote VM for reliable PR detection from git state
- Health metrics in reasoning:
fleet_health.py wired into SessionContext for admiral decisions
- Unified status classifier: Single canonical classifier in
_status.py (no dual TUI/CLI divergence)
- Modular CLI: Commands split across
_cli_session_ops.py, _cli_scout_advance.py, _cli_formatters.py (each under 400 LOC)
- Project grouping: Scout report groups sessions by registered project with open objectives displayed
How to Run
Execute via Bash:
fleet <command> [options]
Presenting Results
After running fleet scout or fleet advance, present the output to the user as:
-
Summary table — reformat the CLI output into a clean markdown table with columns:
VM | Session | Status | Action | Conf | Summary
-
Proposed inputs — for any send_input decisions, show what the admiral wants to send
-
Follow-up commands — always end with the actionable next steps from the report:
fleet advance to send next command to all sessionsfleet advance --confirm to review each before executingfleet advance --session vm:session to advance one specific sessionfleet watch <vm> <session> to inspect specific sessions
