README: FLEET-MANUAL.md v3.0 is the start file

This commit is contained in:
Ty
2026-09-27 17:47:35 +00:00
parent 64e950a55b
commit 4c9217c81c
+8 -18
View File
@@ -1,27 +1,17 @@
# Hermes ↔ Grok Bot operator manual
Wire an existing [Nous Research Hermes Agent](https://github.com/NousResearch/hermes-agent) into the Grok Bot app over a private Tailscale net. Hermes stays the brain. Grok Bot is the front door.
Start here: [FLEET-MANUAL.md](FLEET-MANUAL.md) (v3.0 contract).
This repo is the operator write-up. The comms code lives upstream:
- Bridge: https://github.com/shagghiesuperstar/hermes-grok-bridge
- SSH Relay template: https://x.ai/bot/NVF3Rx9T7jkQPsqYjeDn-
- API Fleet template: https://x.ai/bot/5KLpaL-JIM2q629kbTh5L
- Fleet Ops template: https://x.ai/bot/rzq0UV2MmBsvVR1EspZE-
## Start here
1. Read [MANUAL.md](MANUAL.md) (full TOC).
2. Pick **SSH Relay** if Hermes is Desktop-primary (no gateway).
3. Pick **Native API (:8642)** if the gateway + API server are already up and you want parallel fleet asks.
4. Add identity bots per host. Optional: one Chief of Staff + Fleet Ops.
Agents pass jobs. They do not chat. Wiring (Tailscale, SSH relay, `:8642`) is infra and lives in [MANUAL.md](MANUAL.md) if you need to rebuild a box.
## Hard rules
- Tailscale only. No Funnel. No public bind on `:8642`.
- Never commit `API_SERVER_KEY`, SSH private keys, or vault tokens.
- Do not let Grok write Hermes memory plugins (Hindsight, Graphiti, Omega, MEMORY.md) unless you have an explicit memory plan.
- Account-scoped MCP is visible to every Grok Bot on the account. Confine identity bots in their system prompt.
- Jobs in `Tony_tech/personal-agent-os` → `memory-systems/agent-os/04_projects/<project>/jobs/`
- CoS owns job `state`. Workers only add event files.
- No Funnel. No public bind on `:8642`.
- Never commit keys or vault tokens.
- Grok may read Hermes memory plugins. Grok may not write them.
- Human does every login and every Save / Send / publish / spend.
## Clone