fleet-status

Files (1)

• SKILL.md

SKILL.md (first lines)

# Fleet Status

Instant situational awareness of the entire fleet. One command shows every node's state, active sessions, running tasks, and connectivity health.

## How It Works

1. Your local daemon collects UDP heartbeats from all peers (every 10s)
2. Heartbeats carry node status, git branch, session count, and task state
3. `/fleet/live` merges local state + cached heartbeats into a unified view
4. If a heartbeat is stale (>60s), the daemon does a 1s HTTP probe as fallback

## Quick Check

```bash
# One-liner summary — the most useful command in the fleet
curl -s http://127.0.0.1:8855/fleet/live | python3 -c "import sys,json;print(json.load(sys.stdin)['fleetStatus'])"
# -> "3/3 online: mac1 active, mac2 idle 5m, mac3 working"

# Full node details (JSON)
curl -s http://127.0.0.1:8855/fleet/live | python3 -m json.tool

# This node only
curl -s http://127.0.0.1:8855/health | python3 -m json.tool

# Peer registry with heartbeat timestamps
curl -s http://127.0.0.1:8855/peers | python3 -m json.tool
```

### Via the fleet status script

```bash
bash scripts/multi-fleet-status.sh
```

### Via Python

```python
import requests, json

def fleet_status():
    """Get fleet-wide status from local daemon."""
    try:
        r = requests.get("http://127.0.0.1:8855/fleet/live", timeout=3)
        data = r.json()
        print(data["fleetStatus"])
        for node in data.get("nodes", []):
            name = node["name"]
            status = node["status"]
            idle = node.get("idle_s", 0)
            tasks = node.get("activeTasks", 0)
            branch = node.get("git", {}).get("branch", "?")
            print(f"  {name}: {status} | idle {idle}s | tasks {tasks} | {branch}")
        return data
    except requests.ConnectionError:
        print("ERROR: Fleet Nerve daemon not running on localhost:8855")
        return None
```

## Status Classifications

| Status | Meaning | Condition |
|--------|---------|-----------|
| `working` | Has active fleet tasks running | activeTasks > 0 |
| `active` | Session recently active | idle_s < 300 (5 min) |
| `idle Nm` | Session quiet for N minutes | 300 <= idle_s < 900 |
| `dormant Nm` | Session quiet for N+ minutes | idle_s >= 900 (15 min) |
| `offline` | No heartbeat received | No UDP heartbeat in 60s AND HTTP probe fails |

## Full Response Format

```json
{
  "fleetStatus": "3/3 online: mac1 active, mac2 idle 5m, mac3 working",
  "timestamp": "2026-04-05T10:30:00Z",
  "nodes": [
    {
      "name": "mac1",
      "role": "chief",
      "status": "active",
      "idle_s": 42,
      "activeSessions": 1,
      "activeTasks": 0,
      "git": {
        "branch": "main",
        "lastCommit": "abc1234",
        "lastCommitMsg": "feat: fleet worker pool"
      },
      "surgeons": {
        "cardiologist": true,
        "neurologist": true,
        "atlas": true
      },
      "heartbeat": {
        "lastSeen": "2026-04-05T10:29:58Z",
        "transport": "udp",
        "stale": false
      }
    },
    {
      "name": "mac2",
      "role": "worker",
      "status": "idle 5m",
      "idle_s": 312,
      "activeSessions": 1,
      "activeTasks": 0,
      "git": {
        "branch": "feature/auth",
        "lastCommit": "def5678"
      }
    },
    {
      "name": "mac3",
      "role": "worker",
      "status": "working",
      "idle_s": 5,
      "activeSessions": 2,
      "activeTasks": 1,
      "taskSummary": "Running cross-exam on auth module (45s)"
    }

From supportersimulator/multi-fleet, MIT.

More from supportersimulator/multi-fleet