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.