Documentation

Four guides, rendered from the markdown files in the repository. Start with the usage guide if you want to run the daemon; the other two are reference for each app.

• Overview

  What agent-watchdog is, prerequisites, and the quick start from a clone.

  README.md

• Usage and configuration

  From a fresh clone to a running daemon and menu bar app: the config file, every flag, alerts, and troubleshooting.

  docs/usage.md

• Daemon and CLI reference

  How sessions are found, how context and cache expiry are computed, the commands, flags, status file, and safety rules.

  apps/watchdog/README.md

• Menu bar app

  The native macOS menu bar app: daemon states, the menu, the settings window, and permissions.

  apps/menubar/README.md