What problem does it solve?
It detects anomalies across all enabled atmux teams, triages the likely causes, records an auditable trail, and—when authorized—takes structural corrective actions to keep the fleet healthy.
Core Features & Use Cases
- Fleet-wide diagnostic sweep: Runs
atmux doctor and atmux status --json per enabled team to surface stalls, inconsistencies, and unhealthy states.
- Velocity and context-pressure triage: Classifies teams by shipping progress and headroom to prioritize investigation cost and timing direction.
- Cage-presence verification and guardrails: Uses
cockpit.json cage-mode intent plus tmux socket probing to avoid false-positive escalation.
- Action levels with audit logging: Writes actions to the complaint/audit trail before executing; supports operator-invoked one-shot or dry-run reporting.
- Preventive fix requests and structural remediation: Can rotate leads/clear members/cycle cages, and can open atmux-source PRs when the root cause is in atmux itself.
Quick Start
Use the sweep to run a single full diagnostic and report without making any changes by giving the command: activate sweep with the verb once in dry-run mode.