- Detect the operating system and select the matching script variant.
- Read help and the safe inspection mode.
- Complete the fleet-wide Remote Freshness preflight.
- Review blockers and next actions.
- Run mutations only with explicit authority.
- Evaluate result, exit code, and evidence together.
On macOS/Linux:
bash scripts/maintain-agentic-workspace.sh --check-only
bash scripts/maintain-agentic-workspace.sh --dry-runOn Windows:
pwsh -NoProfile -File scripts/maintain-agentic-workspace.ps1 -CheckOnly
pwsh -NoProfile -File scripts/maintain-agentic-workspace.ps1 -WhatIf--check-only and -CheckOnly inspect state and may perform safe fetches.
--dry-run and -WhatIf preview mutations. An interactive launch selects
preview by default; redirected invocations remain headless.
All registered repositories are inventoried and safely fetched first. One
finding does not end the read-only fleet audit. Pull is allowed only for a clean
default branch with an unambiguous upstream, ahead=0, and a purely behind
state. Dirty, Ahead, Diverged, Detached, Non-Default, missing upstream, or remote
failure blocks mutation.
- Enhanced TUI: interactive surface with text status.
- Plain UI: linear text-oriented selection.
- Headless: explicit options for automation and CI.
All modes use the same maintenance engine and safety boundaries. A fallback may
reduce capability, but it cannot bypass confirmation or blockers. Ctrl+C
produces exactly one traceable interruption path.
The live JSONL stream reports events. The canonical final report and process
exit code jointly determine success, drift, repaired drift, or operational
failure. EVENT_STREAM_DEGRADED means live evidence is incomplete; completion
must not be inferred from the stream alone.
- Detailed efficiency guide
- One-command maintenance manpage
- Maintenance TUI architecture
- Maintenance TUI accessibility
- Script reference
- Preset and fleet lessons
Next action: Run the matching check or preview mode first and read its text-oriented next action.