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

feat(#2089): additive claude.md pointer to in-container docs

Browse source
This commit is contained in:
damocles 2026-06-29 19:59:22 +02:00 • committed by mara
commit 6267bf56d0
3 changed files with 56 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

41
nix/templates/harness-base.nix
View file

@ -100,6 +100,22 @@ let
iconPng = pkgs.runCommand "hive-agent-icon.png" { nativeBuildInputs = [ pkgs.librsvg ]; } ''
rsvg-convert -f png -w 512 -h 512 ${config.hyperhive.icon} -o $out
'';
# hyperhive.docs.enable: the reference-docs tree (`pkgs.hyperhive-docs`,
# the repo `docs/` verbatim) with a generic `CLAUDE.md` pointer dropped
# at the root. The harness passes this dir to claude via `--add-dir`;
# paired with `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` claude
# loads `<dir>/CLAUDE.md` ADDITIVELY (alongside, never replacing, the
# agent's own `~/.claude/CLAUDE.md`). The pointer prose lives in
# `hive-ag3nt/prompts/docs-pointer.md` (prompts belong in prompts/, not
# nix/) and is shipped via `hyperhive-assets`. `hyperhive-docs` itself
# stays pure (no CLAUDE.md) so the website can reuse the same tree.
# Lazy: only forced when `hyperhive.docs.enable` references it below.
agentDocs = pkgs.runCommand "hyperhive-agent-docs" { } ''
mkdir -p $out
cp -r ${pkgs.hyperhive-docs}/. $out/
chmod -R u+w $out
cp ${pkgs.hyperhive-assets}/share/hyperhive/prompts/docs-pointer.md $out/CLAUDE.md
'';
in
{
# Shared scaffolding for every hyperhive harness container.
@ -245,10 +261,12 @@ in
read-only as the standalone `hyperhive-docs` derivation) available
in-container. When enabled the harness exposes the docs dir to claude
via `claude --add-dir`, so the markdown is readable at
`$HIVE_DOCS_DIR/`. The agent is NOT yet pointed at the docs (no
auto-loaded `CLAUDE.md` pointer) — surfacing a pointer is a tracked
follow-up. Default-on for the root/manager agent (see `manager.nix`),
off elsewhere; any agent can flip it from its `agent.nix`.
`$HIVE_DOCS_DIR/`. A generic `CLAUDE.md` pointer is dropped at the dir
root and loaded additively (via
`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`), so the agent knows
the docs exist without its own `~/.claude/CLAUDE.md` being replaced.
Default-on for the root/manager agent (see `manager.nix`), off
elsewhere; any agent can flip it from its `agent.nix`.
'';
options.hyperhive.allowedBashPatterns = lib.mkOption {
@ -1384,12 +1402,15 @@ in
HIVE_COMPACT_WATERMARK_TOKENS = "0";
}
// lib.optionalAttrs config.hyperhive.docs.enable {
# hyperhive.docs.enable: the in-container reference-docs tree
# (`pkgs.hyperhive-docs`, the repo docs/ verbatim). The harness
# reads this and passes it to claude as `--add-dir` so the docs are
# readable; the agent is not auto-pointed at them. See
# hive-ag3nt::turn.
HIVE_DOCS_DIR = "${pkgs.hyperhive-docs}";
# hyperhive.docs.enable: the in-container reference-docs tree plus a
# generic `CLAUDE.md` pointer at its root (see `agentDocs` above).
# The harness reads HIVE_DOCS_DIR and passes it to claude as
# `--add-dir` so the docs are readable; with
# `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` claude also loads
# the pointer additively, telling the agent the docs exist without
# clobbering its own memory. See hive-ag3nt::turn.
HIVE_DOCS_DIR = "${agentDocs}";
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD = "1";
}
// lib.optionalAttrs (config.hyperhive._bashEnvFragments != "") {
# Non-interactive bash invocations (claude's `Bash` tool runs