What problem does it solve?
Observe WezTerm worker runs through mini-pane heartbeats, sleep-loop watchers, cron-friendly checks, and strict manager wakeup delivery. Use when Codex needs to (1) create a small observer pane under a visible worker, (2) watch active | idle | stuck | gone state over time, (3) wake a manager or Shehroz pane when a worker returns to idle, (4) prove inject -> submit -> 30s watch for manager wakeups, or (5) run recurring pane/process heartbeat checks through sleep loops or cron.
Core Features & Use Cases
- Observe and log per-heartbeat truth about worker pane activity, tty state, and wrapper logs.
- Support multiple observation surfaces: mini-pane under the worker, sleep-loop watchers, or cron-based checks, plus one-shot inspections.
- Enforce wakeup proof workflow: inject -> submit -> 30s watch, and report startup_proved when evidence is explicit.
- Not the worker itself; used to monitor, prove, and wake the manager, enabling reliable orchestration.
Quick Start
Launch the observer under a visible worker to start heartbeats monitoring and wakeup proof collection.