From 2e8597b9db8d74d8e9688ff606ed6cbc45707d11 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?m=C3=BCde?= <git@darkest.space>
Date: Fri, 15 May 2026 16:43:20 +0200
Subject: [PATCH] readme: drop "read next" + add minimal host flake.nix example

---
 README.md | 42 ++++++++++++++++++++++++++++++++++++++----
 1 file changed, 38 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 5db0046..f9db804 100644
--- a/README.md
+++ b/README.md
@@ -23,11 +23,45 @@ in a turn loop, exposes a per-agent web UI with a live event stream, and
 talks to the broker over a bind-mounted unix socket via an embedded MCP
 server claude calls into.
 
-## Read next
+## Host config
 
-- **[CLAUDE.md](CLAUDE.md)** — developer reference: conventions, gotchas,
-  per-subsystem design, file map.
-- **[TODO.md](TODO.md)** — open work items.
+Minimal `flake.nix` for a host that runs hive-c0re:
+
+```nix
+{
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.11";
+    hyperhive.url = "git+https://git.berlin.ccc.de/vinzenz/hyperhive";
+  };
+
+  outputs = { nixpkgs, hyperhive, ... }: {
+    nixosConfigurations.my-host = nixpkgs.lib.nixosSystem {
+      system = "x86_64-linux";
+      modules = [
+        hyperhive.nixosModules.hive-c0re
+        ({ ... }: {
+          nixpkgs.overlays = [
+            hyperhive.overlays.default
+            hyperhive.overlays.claude-unstable
+          ];
+          services.hive-c0re = {
+            enable = true;
+            hyperhiveFlake = "${hyperhive}";
+          };
+          # ... rest of your host config (hardware, networking, users, …)
+          system.stateVersion = "25.11";
+        })
+      ];
+    };
+  };
+}
+```
+
+hive-c0re will then:
+- open its admin socket at `/run/hyperhive/host.sock` + dashboard on
+  `:7000`,
+- auto-create the manager container (`hm1nd`) if missing,
+- auto-rebuild any managed container whose hyperhive rev is stale.
 
 ## Build / deploy