Skip to content
Agent Hub

Health And Recovery

Use health and audit before guessing from terminal screenshots.

Quick Board

Section titled “Quick Board”
Terminal window
hub status

Plain status runs one bounded safe maintenance pass. For pure observation:

Terminal window
hub status --read-only
hub status --json

Health

Section titled “Health”
Terminal window
hub health --json

Health reports broken prerequisites and exact fix commands.

Audit

Section titled “Audit”
Terminal window
hub audit --json
hub audit <session> --json
hub audit <run-id> --json

Audit is read-only and useful after restarts, stale workers, stuck composers, or confusing deploy state.

Safe Repair

Section titled “Safe Repair”
Terminal window
hub repair --safe

Safe repair can retry current pending messages, clear obvious broken fragments, request final handoffs, advance queued work, or restart stale controlled workers with continuation. It should ask for human input only when the remaining action is a real decision.

Remote Control

Section titled “Remote Control”
Terminal window
agent-hub-online
hub remote-control start --pair

The Remote Control helper serializes startup, performs narrow stale-daemon recovery, retries transient pairing deadlines, and avoids broad process kills.

Rollback

Section titled “Rollback”

Code rollback and operational-state rollback are separate decisions. To roll back code:

  1. Check out the last known-good source commit.
  2. Run tests.
  3. Install the source runtime.
  4. Restart only processes that need the old engine or prompt.