/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 sessions

• fleet advance --confirm to review each before executing

• fleet advance --session vm:session to advance one specific session

• fleet watch <vm> <session> to inspect specific sessions