25 lines
1.1 KiB
Markdown
25 lines
1.1 KiB
Markdown
# hive-agent-wake
|
|
|
|
A tiny CLI that injects a wake-up event into an agent's own harness
|
|
inbox, so the next turn fires with a given `--from`/`--body`. That's
|
|
the whole crate.
|
|
|
|
## When to use it
|
|
|
|
Reach for this when you're wiring up an `extraMcpServers` daemon
|
|
(scraper, webhook listener, custom integration) that needs to nudge
|
|
claude on some external event — a new item arrived, a long job
|
|
finished, whatever. The built-in daemons (matrix, bash) don't use
|
|
this: they talk to the per-agent MCP socket directly instead. This CLI
|
|
exists so a helper author only needs one small, dependency-light crate
|
|
to get the same effect without linking `hive-agent-mcp` or the full
|
|
`hive-agent` harness lib.
|
|
|
|
## Shape
|
|
|
|
One binary, `src/main.rs`: parses `--socket` (defaults to
|
|
`/run/hive/mcp.sock`, the per-agent MCP socket bind-mounted from the
|
|
host), `--from`, and `--body` (pass `-` to read the body from stdin),
|
|
dials the socket with `hive-core-agent-sock`'s `Request`/`Response`
|
|
wire types, sends a `Wake` request, and exits. It carries its own copy
|
|
of the retrying request client rather than depending on `hive-agent-mcp`'s.
|