observer

Monitor worker pane states and verify wakeup proofs via heartbeat checks.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/almazom/agents_slash_skills --skill observer-almazom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: observer
Source: https://github.com/almazom/agents_slash_skills/tree/main/observer
Command: npx skills add https://github.com/almazom/agents_slash_skills --skill observer-almazom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

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.

Frequently Asked Questions about observer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor WezTerm worker heartbeats and track pane state transitions?▼

To monitor WezTerm worker heartbeats, you observe and verify state transitions for visible panes, tracking idle, active, stuck, and gone states through mini-pane observation, sleep-loop watchers, or cron-based checks.

What is a deterministic wakeup proof path for manager pane delivery?▼

A deterministic wakeup proof path is a strict verification workflow enforcing the sequence of inject, submit, and a 30-second watch to prove manager wakeups, reporting startup_proved when explicit evidence is collected.

How do I wake a manager pane when a WezTerm worker returns to idle?▼

You wake a manager pane when a WezTerm worker returns to idle by using configurable wrappers that monitor heartbeat state and trigger manager wakeup delivery once the idle transition is confirmed.

Can I run recurring process heartbeat checks through cron or sleep loops?▼

Yes, you can run recurring process heartbeat checks by deploying cron-friendly checks or sleep-loop watchers that continuously observe and log per-heartbeat truth about worker pane activity and tty state.

Does the observer run the worker itself or only monitor it?▼

The observer does not run the worker itself; it is strictly used to monitor, prove, and wake the manager, enabling reliable orchestration by logging per-heartbeat truth about worker pane activity.

What is the best way to take a quick snapshot of a WezTerm worker's state?▼

The best way to take a quick snapshot is using a one-shot inspect, which provides an immediate observation of the worker's current activity, tty state, and wrapper logs without a continuous loop.