vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

docs: document the independent subagent daemon (start/continue/interrupt)

Browse source
This commit is contained in:
damocles 2026-09-09 18:15:35 +02:00
commit e64639c4d0
6 changed files with 165 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

23
docs/tools/bash.md
View file

@ -93,15 +93,20 @@ this structured path so tasks get task-id tracking and structured output.
`hive-bash-daemon` is a single long-running process (one per agent
container, systemd service in `nix/agent-modules/mcp.nix`) — no stdio
bridge, no separate bin. It owns subprocess management, output file
writing, todo delivery on the harness's in-agent socket, **and** serves
the `run`/`status`/`kill` MCP tools directly over streamable-http on
`hyperhive.mcp.bashHttpPort` (declared in `hyperhive.extraMcpServers.bash`
as `{ type = "http"; url = ...; }`). Same shape as the built-in
`hyperhive` surface (`hive-mcp-http`) — claude reconnects to the stable
URL every turn instead of respawning a stdio child, so there's no
per-turn MCP re-registration race and no round-trip socket hop for tool
calls.
bridge. It owns subprocess management, output file writing, todo delivery
on the harness's in-agent socket, **and** serves the `run`/`status`/`kill`
MCP tools directly over streamable-http on `hyperhive.mcp.bashHttpPort`
(declared in `hyperhive.extraMcpServers.bash` as `{ type = "http"; url =
...; }`). Same shape as the built-in `hyperhive` surface (`hive-mcp-http`)
— claude reconnects to the stable URL every turn instead of respawning a
stdio child, so there's no per-turn MCP re-registration race and no
round-trip socket hop for tool calls.
Independent daemon (own crate, own process/systemd unit/MCP server
`subagent`): `hive-subagent-daemon` — see [`subagent.md`](subagent.md).
Spawns nested claude sessions rather than shell commands, so it keeps no
task files here or anywhere else; a subagent task never shows up in this
daemon's `status`/`kill` or the running-tasks panel.
### Completion as a todo (loose-ends v2)