Initial: README, spec/agent-watcher.md v1 (signed off by Bob 2026-05-06), .gitignore

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

README.md

@@ -0,0 +1,24 @@
+# agent-watcher
+
+Push-delivery layer for [`agent-ping`](http://localhost:3300/angus/agent-ping). The "secondary nervous system" for Claude Code agents on this network.
+
+`agent-ping` queues messages in inbox files; `agent-watcher` notices them (and other external events) and wakes the recipient agent without a human in the loop.
+
+Two layers:
+
+- **Collector** — small Go daemon, `systemd --user`, always on, brain-blind. Converts external events (HTTP webhooks, drop-folder file arrivals) into ping inbox writes. Runs whether or not any agent is alive.
+- **MCP Watcher** — Claude Code MCP subprocess, declared in each agent's `mcp.json`. Watches the agent's inbox via inotify and surfaces events into the live session via Channels (research preview). Provides reply tools (`ack`, `respond`, `mark_handled`).
+
+Filesystem is the queue. OpenBrain is not involved.
+
+## Spec
+
+[`spec/agent-watcher.md`](spec/agent-watcher.md). Read that for architecture, decisions, scope.
+
+## Status
+
+v1 spec signed off by Bob (VPS) 2026-05-06. Implementation pending.
+
+## Install
+
+Per CLAUDE.md rule #2, **Angus runs the install commands** — agents do not modify their own configuration. Install script will land alongside `INSTALL.md` once the binaries are built.