Install, then
you're on watch.
Drag Vigil to Applications, open it, then connect Claude Code or Codex. Because releases are intentionally ad-hoc signed, macOS may need one explicit confirmation.
Download, then drag it in.
Grab the build for your Mac (Apple Silicon, 5.7 MB or Intel, 6.0 MB), open the dmg, and drag Vigil into Applications.
Open Vigil normally. If macOS blocks the first launch, open System Settings → Privacy & Security and choose Open Anyway beside the Vigil notice.
You're on watch.
Vigil settles into the menu bar. Connect Claude Code or Codex from Settings, using a desktop app or CLI. For Codex CLI hooks, run /hooks and trust each yellow Review item. Desktop session tracking and plan-limit sign-ins are checked separately. Status goes live on the next local agent event.
Claude Desktop: sign in, open the local Code tab, and start a session. In Vigil, choose Claude Desktop under Settings → Permissions & access, then Refresh. You do not need the CLI installed for this path. An ordinary Claude chat sign-in alone may not expose the required Code credential.
Codex Desktop: use its existing ChatGPT sign-in. If you use either CLI instead, sign in there and choose the appropriate source in Vigil. Fable limits and Codex banked resets appear when your account reports them.
W 86% Thu 10 Sep 9:41 PM
Updates stay checkable.
Vigil checks for new versions quietly and lights an update arrow in the menu bar when one is out. Releases are intentionally ad-hoc signed, with no Apple Developer ID or personal signing identity attached, so macOS may ask you to approve the first launch in Privacy & Security. An update can also require Accessibility to be re-authorized for exact click-to-focus; the permissions section below shows how. CI verifies the anonymous signature, app contents, architecture, and version, and each release publishes an architecture-specific SHA-512 value to compare with the downloaded DMG.
The optional permissions, plainly.
Watching your agents does not require special macOS access. Accessibility and Automation support exact click-to-focus. Reading a Claude sign-in may also request Keychain access when you explicitly connect or refresh.
/Applications/Vigil.app.What it writes, and removing it.
Vigil is tidy on purpose. Here's everything it touches, and how to take it all back.
~/.vigil/ holds the local server port, an auth token, and any sound packs you install.~/.claude/settings.json (Claude Code) and ~/.codex/config.toml (Codex) by default; CLAUDE_CONFIG_DIR and CODEX_HOME are honored. Your existing settings are preserved; only Vigil's hook entries are added. CLI hook review happens in the terminal. Plan-limit authentication is separate: choose Claude Desktop or Claude Code CLI in Vigil, or use Codex’s existing supported desktop/CLI ChatGPT sign-in.~/Library/Application Support/Vigil. Nothing leaves your Mac.