Wiki
A stronger documentation landing page for the current multi-agent program: live project state, execution rules, durable decisions, and the user context shaping how the team operates.
Project state
Track
Track
Track
Track
Completed milestones
Quick routes
Operating model
Odysseus handles coding execution and worker runtime, while Hermes remains the orchestration, review, integration, and externally hosted surface.
Externally hosted services stay on the Hermes host unless David explicitly directs otherwise.
The canonical vault lives at /opt/brain on NNW22586 so agents can keep durable context on a shared filesystem.
Agent replies must use raw mention format like <@1493676856388485180>, and auto-threading must remain disabled because threads break Quinn's receive loop.
User and team context
Lead
David (dasani) — project lead and stakeholder.
Communication
Direct, terse replies with no padding; raw mention format for Quinn is expected in all agent responses.
Current team shape
Quinn is the orchestrator, Kujo handles research and integration, Zephyr is an engineering lane, and Odysseus is the coding executor.
Infrastructure context
Agents operate on NNW22586 and coordinate through Discord, with canonical external hosting staying on Hermes by default.
Host service
Outstanding
External play needs a router port-forward of TCP 25565 to 192.168.1.49, plus a DHCP reservation for that address so the forward survives a lease renewal.
Traps worth remembering
The java command line is only 'java @user_jvm_args.txt', so ps and /proc reveal nothing. Read /home/minecraft/data/user_jvm_args.txt to see the heap and GC flags actually in effect.
A CurseForge key is bcrypt-shaped, and Compose treats $ as interpolation even inside env_file, truncating the key to '$2a'. Every dollar sign must be doubled. Note also that the 36-character UUID in the CurseForge console is the Upload token, not the REST API key.
Key decisions
These are the durable rules currently shaping delegation, hosting, and shared memory.
2026-07-29
The host's CurseForge key is valid but unauthorized for the mods/search endpoint, which both CF_SLUG and CF_PAGE_URL resolve through, so TYPE=AUTO_CURSEFORGE cannot work. The v51 server pack is self-contained, so the stack pins TYPE=NEOFORGE with GENERIC_PACKS instead and needs no API key at all.
2026-07-29
Aikar flags pre-touch the whole heap, so java holds roughly 9.3G resident from boot and leaves the 15G host near 1G available. Rather than shrink the heap, ollama is stopped manually during play sessions. An 11G container cap still prevents a GC spike from killing nginx or syncthing.
2026-06-03
Odysseus is now the coding executor lane, while Kujo/Hermes remains the orchestrator, reviewer, and verifier because the worker API and workspace model are proven enough for delegated implementation work.
2026-06-03
Public and external services stay centralized on Hermes so coding execution can move faster without fragmenting host-facing integration.
2026-06-03
Odysseus uses a dedicated host-visible git-backed clone mounted into the worker runtime so edits preserve real .git visibility, changed_files, and patch output while staying isolated from the main checkout.
2026-04-16
The shared vault lives at /opt/brain, raw Discord mention format is mandatory, and Hermes auto_thread must remain false so Quinn can reliably see replies.