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

docs(turn-loop): add dedicated section for hyperhive.docs.enable agent.nix option

Browse source 
The option was only mentioned in passing in the system-prompt render
section. Add a proper ### section (following the pattern of Agent icon,
user.passwordlessSudo, etc.) with the nix snippet, default, effect on
$HIVE_DOCS_DIR + system prompt, and a note on the narrow docs flake
input that avoids full container rebuilds on doc edits.
This commit is contained in:
iris 2026-07-04 13:27:28 +02:00 • committed by mara
commit b41e3276c3
1 changed files with 19 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

19
docs/turn-loop.md
View file

@ -322,6 +322,25 @@ write_settings, write_system_prompt, run_turn, drive_turn,
emit_turn_end, wait_for_login, compact_session}` — the single code path
every agent role runs through.
### Reference docs (`hyperhive.docs.enable`)
```nix
hyperhive.docs.enable = true; # default: false (true for the manager agent)
```
Mounts the hyperhive `docs/` tree read-only inside the container at
`$HIVE_DOCS_DIR` (typically `/run/hyperhive-docs`) and injects a single
pointer sentence into the agent's system prompt so it knows the docs exist
and where to find them. The mounted tree is served by `claude --add-dir` so
the full markdown is readable during every turn.
Enabled by default only for the root/manager agent (`manager.nix`). Any
agent can opt in by adding the line above to its `agent.nix`.
The `docs/` source is a narrow flake input (`hyperhive-docs`) tracked
separately from the main `hyperhive` flake so editing docs re-locks only
that input — not every agent's container gets rebuilt on a doc-only change.
### Agent icon
```nix