API Reference canaryd v#0.2.0

Copy Markdown View Source

Modules

Mac health monitor: thermal, resources, and functional app probes.

CleanClip health: L2 process liveness + L3 functional clipboard probe.

Reads the macOS WindowServer unresponsive state for supported GUI processes.

escript entry: check | thermal-check | status | history [target] | install | uninstall

One full health-check round

Defines milliseconds as the internal time unit.

macOS notifications. Used only when user attention is required.

Runs a reversible probe transaction on a macOS pasteboard.

Self-installing launchd agent. launchd is an implementation detail: users never touch plist files. Every CLI invocation ensures the agent is present and loaded; if the user deletes it, the next run heals it.

Pure transition logic for per-target health. Testable without side effects.

DETS-backed persistent state.

L1 system-level health: thermal throttling, load, memory pressure, and user idle detection (keyboard/mouse via IOHIDSystem HIDIdleTime).

Reads Apple Silicon CPU and GPU sensor temperatures from macmon.

Confirms sustained thermal pressure and limits user action prompts.

Pure confirmation and cooldown policy for unresponsive GUI apps.