24 lines
1.2 KiB
Markdown
24 lines
1.2 KiB
Markdown
# 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.
|