Diagrams And Maps

A visual atlas for the local agent control room.

These plates and diagrams are quick maps for the hive: what talks to what, where state lives, which rails move money or tokens, and where the trust boundaries sit.

Generated Infographic Plates

Generated HivemindOS visual atlas infographic showing Fleet, Agents, Brain, Work, Wallets, and Native around the dashboard. — Generated overview plate for the full HivemindOS visual atlas.

Generated wallet and token rails infographic with separate lanes for x402 paid APIs, UsePod prepaid runtime deposits, and Honey to Bankr HIVE claims. — Wallet rails are three separate paths: wallet to x402, wallet to UsePod prepaid runtime, and runtime usage to Honey to Bankr HIVE claim.

Generated fleet and Tailnet topology infographic showing dashboard, local collector, Tailnet or Link, remote collectors, apps, and runtimes. — Dashboard to local collector, then private Tailnet reachability out to remote collectors, machine health, apps, and runtimes.

Generated brain services and shared vault infographic showing ENV vault path, Obsidian Vault, Skills, GBrain, Syntho, Trading Brain, and Synthesis Folder. — ENV vault path into Obsidian, shared skills, GBrain retrieval, Syntho reviewed output, Trading Brain, and the Synthesis folder.

Generated workboard and scheduler loop infographic showing Ideas, Ready, Working, Done, Scheduler, Deliverables, and History. — Workboard lanes, scheduler loop, deliverables, and history.

Generated security and trust boundaries infographic showing Public Docs, Browser, Local API, Private Vault, Wallet Keys, Tailnet, and Workers. — Security boundaries across public docs, local APIs, wallet keys, Tailnet, and workers.

Generated AEON and native desktop infographic showing Tauri, Local Files, AEON Repo, GitHub Actions, Deliverables, and Shared Vault. — AEON, Tauri native bridge, local files, GitHub Actions, deliverables, and shared vault.

Rendered System Maps

Control Room Map Dashboard, APIs, collectors, runtimes, vault, workers. Fleet Topology Local collector, remote collectors, Tailnet, app proxying. Runtime Chat Path Agent profile to adapter to stream/session storage. Wallet Token Rails Base, Solana, USDC, MoneyClaw, UsePod, x402. Honey And HIVE Flow Observed usage, Honey ledger, Bankr claim path. Workboard Lifecycle Ideas, assignment, runs, deliverables, history. Scheduler Loop Shared schedules, runtime actions, skills, run phases. Brain Services Obsidian, skills, GBrain, Syntho, trading brain. Native Bridge Tauri-first local actions with browser fallbacks. Phone And Voice Gateway, pairing, ring-agent, dashboard calls. AEON GitHub Path OAuth, repo setup, Actions, OIDC brain access. Security Boundaries Local-only, Tailnet-only, public Pages, wallet keys.

Operator Signals

Primary StateShared Obsidian vault, `~/.hivemindos`, runtime homes, and browser preferences.

Private NetworkCollectors, Link proxy, app proxies, Syncthing, and Tailnet services stay private.

Money SurfaceAgent wallets, UsePod deposits, Honey/HIVE accounting, x402, and Bankr claims are explicit rails.

Control Room Map

flowchart LR
  User["Operator"] --> Browser["Browser or Tauri window"]
  Browser --> Dashboard["Next.js dashboard"]
  Dashboard --> Api["App Router API facade"]
  Api --> Vault["Shared Obsidian vault"]
  Api --> Home["~/.hivemindos state"]
  Api --> Native["Tauri native commands"]
  Api --> Collector["Local collector"]
  Collector --> LocalRuntime["Local runtimes"]
  Collector --> LocalApps["Local apps and APIs"]
  Api --> Link["Hivemind Link / Tailscale"]
  Link --> RemoteCollectors["Remote collectors"]
  RemoteCollectors --> RemoteRuntime["Remote runtimes"]
  RemoteCollectors --> RemoteApps["Remote apps and APIs"]
  Api --> Workers["Honey / compute workers"]
  Api --> Integrations["Nango / GitHub / UsePod / MiroShark"]

Product Surface Infographic

01FleetDiscovers machines, collectors, app badges, health, and hivenet services.

02AgentsProfiles bind runtime, model, env, wallet, vault, machine, and call context.

03WorkKanban, scheduler, swarm, history, note intake, and deliverables.

04BrainObsidian memory, graph, shared skills, GBrain, Syntho, trading brain.

05WalletsBase/Solana, USDC, UsePod deposits, MoneyClaw, Honey, HIVE, x402.

06NativeTauri status, local folder actions, deliverable opening, packaged server.

Fleet Topology

flowchart TB
  Dashboard["Fleet dashboard"] --> Snapshot["/api/fleet/snapshot"]
  Dashboard --> Apps["/api/fleet/apps"]
  Dashboard --> Icons["/api/fleet/app-icon"]
  Snapshot --> LocalCollector["This Mac collector"]
  Snapshot --> LinkProxy["Hivemind Link proxy"]
  LinkProxy --> RemoteCollectorA["Remote collector A"]
  LinkProxy --> RemoteCollectorB["Remote collector B"]
  LocalCollector --> LocalProcesses["Processes / runtimes / tasks"]
  RemoteCollectorA --> RuntimeA["Hermes / OpenClaw / AEON"]
  RemoteCollectorB --> RuntimeB["Hermes / OpenClaw / AEON"]
  Apps --> AppReports["Collector /apps reports"]
  Apps --> AppProxy["/app-proxy/{port}"]
  AppProxy --> InteractiveApps["Interactive apps"]
  AppProxy --> ApiServices["API-only services"]
  ApiServices --> RouteCatalogs["OpenAPI or Hivemind route catalogs"]

Runtime Chat Path

sequenceDiagram
  participant O as Operator
  participant D as Dashboard
  participant A as Agent Profile
  participant API as /api/chat/agent-runtime
  participant R as Runtime Adapter
  participant C as Collector or Gateway
  participant S as Session Store
  O->>D: Send message, files, directories
  D->>A: Resolve runtime, model, env, wallet, vault
  D->>API: Submit normalized chat request
  API->>R: Select adapter
  R->>C: Local gateway, Link proxy, or remote collector
  C-->>R: Stream events / final response
  R-->>API: Normalized chunks
  API-->>D: Streaming UI events
  API->>S: Session and usage metadata

Wallet Token Rails

flowchart LR
  Agent["Agent wallet config"] --> LocalVault["Local wallet vault"]
  LocalVault --> Base["Base wallet"]
  LocalVault --> Solana["Solana wallet"]
  Base --> USDC["USDC sends with caps"]
  Solana --> SolanaUSDC["Solana USDC sends"]
  Agent --> UsePod["UsePod prepaid rail"]
  UsePod --> Deposit["Token deposit address"]
  UsePod --> Proxy["UsePod proxy URL"]
  Agent --> MoneyClaw["MoneyClaw API key"]
  MoneyClaw --> Account["Account / wallet / inbox"]
  Agent --> X402["x402 paid request policy"]
  X402 --> PaidApi["Paid API endpoint"]
  LocalVault --> Backup["Encrypted wallet-vault backup"]

Honey HIVE Flow

flowchart TD
  RuntimeUsage["Runtime usage analytics"] --> Observer["Honey usage observer"]
  Observer --> PrivacyFilter["Privacy filter: no prompts, files, keys, paths, Tailnet IPs"]
  PrivacyFilter --> HoneyLedger["Honey ledger"]
  ComputeGateway["Compute gateway"] --> WorkerReceipt["Signed receipt"]
  WorkerReceipt --> HoneyLedger
  HoneyLedger --> Honey["Available Honey"]
  Honey --> LegacyHive["Legacy ledger HIVE"]
  LegacyHive --> Return["Return to Honey"]
  Honey --> BankrClaim["Claim Bankr HIVE"]
  BankrClaim --> Treasury["Bankr reward treasury"]
  Treasury --> BaseWallet["Operator Base receiving address"]

Workboard Lifecycle

stateDiagram-v2
  [*] --> Ideas
  Ideas --> Ready: promote / note intake
  Ready --> Working: agent claim
  Working --> NeedsYou: auth / approval / blocked
  NeedsYou --> Ready: unblocked
  Working --> Done: completed
  Done --> Archived: archive
  Done --> Ready: child handoff promoted
  Working --> Ready: stale reclaim
  Done --> History: work history entry

Scheduler Loop

flowchart LR
  SharedSchedules["Shared schedule files"] --> SchedulerUI["Scheduler UI"]
  SchedulerUI --> RuntimeAction["/api/scheduler/runtime-action"]
  SchedulerUI --> SkillAction["/api/scheduler/skill-action"]
  RuntimeAction --> Adapter["Runtime adapter"]
  SkillAction --> SharedSkill["Shared skill"]
  Adapter --> Run["Runtime run"]
  SharedSkill --> Run
  Run --> Phases["assigned -> thinking -> executing -> wrapping -> done"]
  Phases --> VaultLog["Shared vault run log"]
  VaultLog --> History["Work History"]

Brain Services

flowchart TB
  Vault["Obsidian vault"] --> Graph["Brain graph"]
  Vault --> Skills["Shared skills shelf"]
  Vault --> ServiceNotes["Operations / Brain Services"]
  Graph --> Dashboard["Brain Services cockpit"]
  Skills --> RuntimeSkills["Runtime skill sync"]
  Dashboard --> GBrain["GBrain import / embed / dream / query"]
  Dashboard --> EnvPath["NEXT_PUBLIC_OBSIDIAN_VAULT_PATH"]
  EnvPath --> Vault
  Dashboard --> Syntho["Syntho reviewed-memory pipeline"]
  Dashboard --> Trading["Trading brain status"]
  Syntho --> Synthesis["Synthesis folder"]
  Syntho --> SourcePolicy["Source access policy: deny by default"]
  GBrain --> Query["Graph memory query"]

Native Bridge

flowchart LR
  Feature["Dashboard feature"] --> IsTauri{"Tauri and local target?"}
  IsTauri -->|yes| NativeCommand["Native command"]
  IsTauri -->|no| ApiFallback["Next API fallback"]
  NativeCommand --> LocalFolder["Local folder browse/create"]
  NativeCommand --> Status["Desktop status"]
  NativeCommand --> Deliverables["Open/reveal deliverables"]
  ApiFallback --> BrowserRoute["Browser route"]
  BrowserRoute --> CollectorRoute["Remote collector route"]
  CollectorRoute --> RemoteMachine["Remote machine"]

Phone Voice

sequenceDiagram
  participant D as Dashboard
  participant API as /api/phone
  participant G as Call Gateway
  participant M as Mobile Device
  participant A as Agent Context
  D->>API: Pair, status, ring, or dashboard call
  API->>G: Build gateway request
  G->>A: Add AEON repo, memory, skills, artifacts
  alt Ring mobile
    G->>M: ring-agent push/call
  else Dashboard call
    G-->>D: LiveKit/dashboard-agent-call config
  end

AEON GitHub

flowchart TD
  OAuth["GitHub OAuth fallback"] --> GHGlobal["GH_GLOBAL in shared env"]
  GHGlobal --> AeonRepo["AEON repo/workspace"]
  AeonRepo --> Secrets["GitHub Actions secrets sync"]
  AeonRepo --> Workflows["Workflow dispatch / schedules"]
  Workflows --> Runner["GitHub Actions runner"]
  Runner --> OIDC["OIDC token"]
  OIDC --> Tailnet["Tailscale short-lived client"]
  Tailnet --> BrainEndpoint["/api/runtimes/aeon/brain"]
  BrainEndpoint --> Policy["Visibility-scoped brain policy"]
  Policy --> VaultRead["Search / read / append / bulk"]

MiroShark And Swarm

flowchart LR
  SwarmUI["Swarm theater"] --> Templates["Scenario templates"]
  Templates --> MiroShark["MiroShark companion"]
  MiroShark --> Simulation["Simulation run"]
  Simulation --> Archive["Run archive"]
  Simulation --> Outputs["Posts / market / graph / telemetry"]
  Outputs --> Intelligence["Run intelligence"]
  Intelligence --> AnalysisAgent["Analysis agent"]
  AnalysisAgent --> Publish["Publish or handoff"]
  Publish --> Workboard["Workboard deliverables"]

Storage Map

flowchart TB
  BrowserStorage["Browser localStorage"] --> UIPrefs["UI prefs and fast caches"]
  Home["~/.hivemindos"] --> Env["Shared env"]
  Home --> Kanban["Kanban fallback"]
  Home --> WalletVault["Wallet vault"]
  Home --> MemorySamples["Memory samples"]
  Home --> RuntimeRegistry["Runtime agent registry"]
  Vault["Obsidian vault"] --> SharedBrain["Shared brain notes"]
  Vault --> Skills["Skills"]
  Vault --> Schedules["Schedules"]
  Vault --> WalletLedger["Wallet records"]
  RuntimeHomes["Runtime homes"] --> Hermes["~/.config/hermes"]
  RuntimeHomes --> OpenClaw["~/.openclaw"]
  RuntimeHomes --> Aeon["AEON repos/workspaces"]

API Surface Map

flowchart TB
  Api["/api"] --> Fleet["fleet/*"]
  Api --> Chat["chat/*"]
  Api --> Runtimes["runtimes/*"]
  Api --> Brain["brain/* and obsidian/*"]
  Api --> Work["kanban, scheduler, work-history"]
  Api --> Wallet["wallet/* and honey-ledger"]
  Api --> Integrations["integrations/*, gitlawb/*, projects/*, usepod/*, miroshark/*"]
  Api --> Ops["maintenance, memory-telemetry, runtime-files"]
  Fleet --> Collectors["Collectors and app proxies"]
  Chat --> RuntimeAdapters["Runtime adapters"]
  Brain --> Vault["Obsidian vault"]
  Work --> SharedSchedules["Schedules, task boards, and project proof links"]
  Wallet --> PaymentRails["Token and payment rails"]

Security Boundaries

flowchart LR
  PublicDocs["Public GitHub Pages docs: no secrets"]:::public
  Browser["Operator browser"]:::local
  LocalApi["Local dashboard API"]:::local
  Native["Tauri native commands"]:::local
  Vault["Private Obsidian vault"]:::private
  WalletKeys["Wallet keys"]:::private
  Tailnet["Tailnet / Link"]:::tailnet
  Collector["Collectors"]:::tailnet
  RemoteApps["Remote apps"]:::tailnet
  Workers["Honey / compute workers"]:::external

  PublicDocs -.-> Browser
  Browser --> LocalApi
  LocalApi --> Native
  LocalApi --> Vault
  LocalApi --> WalletKeys
  LocalApi --> Tailnet
  Tailnet --> Collector
  Collector --> RemoteApps
  LocalApi --> Workers

  classDef public fill:#f7ead8,stroke:#b87319,color:#141716
  classDef local fill:#e6f3f0,stroke:#0a8fa6,color:#141716
  classDef private fill:#f8f3e8,stroke:#1e2724,color:#141716
  classDef tailnet fill:#eef5ef,stroke:#27865f,color:#141716
  classDef external fill:#fffdf8,stroke:#bbb3a3,color:#141716

Visual Reading Order

AStart with topologyUse Control Room and Fleet maps to understand reachability.

BFollow stateUse Storage, Brain, Workboard, and Scheduler maps for durable data.

CInspect riskUse Wallet, Honey/HIVE, Native, AEON, and Security maps for trust boundaries.