From 832c2f86c5be617b236d721cc6c290f9f045f292 Mon Sep 17 00:00:00 2001
From: lexis <lexis@hyperhive>
Date: Sat, 23 May 2026 00:44:42 +0200
Subject: [PATCH] docs: clarify hyperthive.model priority in README

PR #321 changed the model priority to: HIVE_DEFAULT_MODEL (from nix config)
> persisted runtime choice > compiled-in DEFAULT_MODEL. The README now
clarifies that the nix config takes precedence and runtime overrides are
reset on rebuild.
---
 README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 241e0a6..a122f2e 100644
--- a/README.md
+++ b/README.md
@@ -84,8 +84,10 @@ Per-agent settings live in each agent's `agent.nix` and are synced to
 the container as environment variables. Common options:
 
 - **`hyperhive.model`** — Claude model for this agent (default: `"haiku"`).
-  Sets `HIVE_DEFAULT_MODEL` in the container; the operator can override
-  at runtime via the per-agent web UI (persisted to state dir).
+  Sets `HIVE_DEFAULT_MODEL` in the container; the harness applies it at
+  boot and it takes priority over any persisted runtime override. The
+  operator can still switch the model at runtime via the per-agent web UI,
+  but that choice is reset by any rebuild that changes this option.
 - **`hyperhive.allowedRecipients`** — List of agent names this agent can
   message (via `send`). If unset, all agents are allowed. Useful to
   restrict an agent to talking only to the manager.