claude-fleet-healthlisted

Operate and monitor the scheduled Claude Code credential automation on a macOS fleet — the com.claude.fleet-refresh and com.claude.fleet-health LaunchAgents, their logs, and the alerts that catch the OAuth refresh-token race before an account is needed. Use when checking whether the fleet is healthy, when an account died or shows EXPRD, when cswap reports null headroom or "re-login needed", when a scheduled push seems to have stopped, or when setting up / auditing the fleet-refresh and fleet-health agents.
soulmachine/skills · ★ 3 · AI & Automation · score 76

Install: claude install-skill soulmachine/skills

# Claude fleet health The operational layer over the two credential skills. `refresh-claude-account` repairs one account, `sync-claude-accounts` distributes credentials — this skill covers the **scheduled automation that runs them** and the monitoring that tells you when it has broken. Everything here runs on the **refresh authority** (the one machine allowed to refresh OAuth tokens). On this fleet that is the MacBook Air; the receivers are mac-mini-2018, mac-mini-m2, archs-mac-mini and mac-studio-m3. ## What is running Two LaunchAgents on the authority, both loaded and verified (`last_exit=0`): | Agent | Cadence | Does | |---|---|---| | `com.claude.fleet-refresh` | 30 min | Exports live credentials, pushes to the 4 receivers with `IMPORT_FORCE=1` | | `com.claude.fleet-health` | hourly | Alerts on dead slots / null headroom / unreachable hosts | Backing files: | Path | Role | |---|---| | `~/.local/bin/fleet-refresh-credentials` | The push cycle. `--dry-run` reports what it would do without touching anything | | `~/.local/bin/fleet-health-check` | The monitor. `NOTIFY=0` suppresses the desktop notification | | `~/Library/LaunchAgents/com.claude.fleet-refresh.plist` | `StartInterval` 1800, `RunAtLoad` true | | `~/Library/LaunchAgents/com.claude.fleet-health.plist` | `StartInterval` 3600 | | `~/Library/Logs/fleet-refresh.log`, `fleet-health.log` | Per-cycle transcripts | | `…/fleet-refresh.err.log`, `fleet-health.err.log` | Should stay empty; content here means the agent