Home / ARCHITECTURE.md
Architecture
Architecture
Machines
flowchart LR
subgraph Box["Box (shared Debian x86_64 VM)"]
Bots["17 active Grok Bots"]
CLIs["claude, codex, hermes, swift, xtool"]
end
subgraph Tailnet["Tailnet (box joined, userspace)"]
Mini["Mac mini: ~/projects, Xcode, oMLX, Ollama"]
MBP["MacBook Pro (M4 Max)"]
Neo["The Neo"]
Omarchy["AMD dev PC (omarchy): strongest for coding + local AI"]
NAS["NAS (backup mirror; all edits allowed)"]
end
Box -- "tssh mini/mbp/neo (SSH 22)" --> Mini
Box -- "oMLX HTTPS 443, tailnet only" --> Mini
Box -. "SSH 22" .-> MBP
Box -. "SSH 22" .-> Neo
Box -. "tailnet: omarchy-ai" .-> Omarchy
Bots -- "desktop connector, mac-mini-files" --> Mini
Bot handoffs
flowchart TD
Atlas --> Beacon
Atlas --> Scout
Atlas --> Ledger
XB[X Bookmarks] -- app flags --> Atlas
Scout -- bulk research --> Hermes[Hermes CLI]
Scout -- success data --- Ledger
Studio -- experiment IDs --- Ledger
BookGrowth[Book Growth] -- Friday Amazon --- Atlas
Atlas -- runtime failures --> Warden
IMB[Improve My Bots] -- symptoms --> Warden
Warden -- X MCP gate --> Scout
Foreman -- PROJECTS/ACTIVITY read-only --> Atlas
Foreman -- heavy coding --> Hermes
Archivist -- meaningful changes --> Atlas
HT[Hermes Tuner] -- tunes box install --> Hermes
HT -- runtime incidents --- Warden
Lanes in one line
- Runtime: Warden. Config and profiles: Improve My Bots (split Oct 10, 2026).
- Portfolio gate: Atlas. Sites: Beacon. Experiments: Ledger. Listening: Scout. Content: Studio. Pitches: Outbound Prospecting.
- Projects: Foreman (single root: AIMacMini:~/projects). Coding agent: Hermes (not a Grok Bot). Box Hermes v0.22.2 (gpt-6.1-sol via openai-codex), tuned by Hermes Tuner. Mac mini Hermes v0.22.2 (MiniMax-M3).
- Strongest coding/local-AI machine: AMD dev PC
omarchy(see infra/omarchy.md). Apple builds stay on the Mac mini.
Open items
See OPEN-WORK.md (single master list). CLI rollout, Tax Collector mission, and Inbox Cleaner receipt rule applied 2026-10-16; Life events description still waiting on Ian; All NAS edits are allowed, with the single root AIMacMini:~/projects staying canonical (settled per Ian, confirmed in the Archivist chat 2026-10-16 8:04 PM CT; supersedes the narrow PROJECTS.md/ACTIVITY.md exception), see decisions/2026-10-16-nas-editable.md.
Rendered diagrams
