HivemindOS manual

Feature Guide

HivemindOS is a control room for local agent fleets.

The feature surface follows the work an operator actually does: connect machines, configure agents, run work, preserve memory, manage money rails, and keep the local system healthy.

Use this page as the operator map.

Each section below explains what the feature area is responsible for, which docs go deeper, and how the pieces connect in the running app. For the full visual pass, use the Diagrams And Maps atlas.

ConnectFleet, collectors, Tailnet/Link, apps, and runtime discovery.
OperateAgents, chat, Work board, Code Proof, Scheduler, Swarm, and deliverables.
VerifyCompletion checks, trusted evidence, independent reviewers, and honest unobserved states.
RememberObsidian vault, shared skills, QMD, Neo4j, GBrain, Syntho, Synthesis, and notifications.
PayWallets, crypto rail routing, Base/Robinhood/Solana, USDC/USDG, Hive Compute, Honey, HIVE, and x402.
IntegrateGitLawb, MiroShark, app connections, GitHub OAuth, My Apps, phone, and work history.
MaintainHivemind Sync, runtime files, native helpers, memory telemetry, and repair checks.

Control Room

The product starts with machines and agents. Fleet tells you what is online, which collectors are reachable, what runtimes and apps are available, and whether a machine is drifting from the expected setup. Agents and Chat turn those runtimes into configured workers with models, env, wallets, vault context, file attachments, and session history.

Fleet

Machine discovery, local and remote collectors, version drift, setup actions, active app badges, and hivenet API route catalogs.

Open Fleet

Fleet Machine Permissions

Collector-only machines, per-capability Allow/Ask/Deny controls, master-hub authority, approval handoffs, and CPU/RAM/storage routing limits.

Open machine permissions

Agents, Runtimes, And Chat

Runtime profiles, model selection, adaptive free-model routing, adapter behavior, streaming chat, `/swarm [number]` agent-team passes, `/swarm-goal` build orchestration, attachments, directory context, and phone-call handoff.

Open agents

Local Document Reader

Sixteen bundled file extensions, local native conversion, Chat attachments, Hive Vault Feed the brain imports, company data rooms, archive limits, and trust boundaries.

Open document reader

Capability Plan Approvals

Review the installed and setup-required capabilities behind a chat build, choose alternatives, remove entire task steps, and control when autonomous work should ask first.

Open capability approvals

Calling

Dashboard and mobile agent calls, BYOK Realtime by default, speaker-only fallback, phone pairing, and paid LiveKit/SFU cloud rooms.

Open calling docs

Looped Work

Looped work is where operator intent turns into agent execution. A loop contract can start from chat, Scheduler, Queen Bee, Evo, a company launch, or the Work Board. The board remains one access path: it captures rough ideas, promotes ready tasks, tracks claimed work, stores comments and run records, and turns finished output into deliverables. HivemindOS evaluates managed completions so agents do not get credit just for saying done. Zero Human Companies add a company cockpit with two autonomy choices: the default HivemindOS crew engine uses the Work Board and private learning loops, while the optional AEON engine runs one saved background skill and records accepted handoffs in Company Runs. Scheduler adds repeated background work. Chat can launch /swarm [number] agent-team passes for parallel role-specific analysis, or /swarm-goal <build request> to rewrite a loose build request and hand it to Queen Bee for parallel agent execution. Swarm and MiroShark handle rehearsal, /swarm-sim simulations, and heavier analysis workflows.

Zero Human Companies

Agent-run company cockpits with charters, apex goals, approvals, budgets, kill switches, Company Runs, and either a HivemindOS crew or an optional AEON background skill.

Open company docs

Work Board And Scheduler

Kanban tasks as one loop access path, generic loop contracts, templates, eval gates, project provenance, Code Proof badges, agent dispatch, deliverables, schedules, machine-aware folder picking, background jobs, and work history.

Open work docs

Loop Engineering

Pattern registry, readiness levels, budgets, receipts, human gates, and exportable loop snapshots for bounded autonomous work.

Open loop docs

Agent Evaluations

Shared completion checks across chat, Work Board, companies, schedules, and managed runtime tasks, with trusted evidence and separate reviewers for consequential work.

Open evaluation docs

Agent Challenges

Bounded multi-agent objectives with public challenge boards, credited lineage, per-agent run caps, verifier rulings, significance thresholds, and shared playbooks.

Open challenge docs

Quant Research Swarm

Research-only hypothesis families with lagged Rust backtests, independent Python validation, hard overfitting gates, regime and factor audits, and durable lineage.

Open quant research docs

MiroShark And Runtime Gateways

Simulation templates, `/swarm-sim` chat launches, swarm rehearsal, run intelligence, route catalogs, and the minimal runtime-gateway integration points HivemindOS owns.

Open gateway docs

Evo Optimization Runs

Benchmark-driven optimization loops as a managed runtime: gated experiment trees in git worktrees, Hermes-hosted orchestration, experiment status and dashboard discovery, and fleet machines as remote SSH backends.

Open Evo docs

Code Proof

Agent work gets messy fast if the only record is a chat transcript or a commit message. HivemindOS keeps the private trail: which task was opened, which project it belonged to, which machine handled it, and which agent touched it. GitLawb adds the part that code needs, signed provenance.

The goal is not to make every user manage a code node on day one. The normal path is quieter than that. HivemindOS can be Code Proof ready during setup, tasks can attach to projects, and linked projects can carry GitLawb proof metadata. If a project later needs local repo hosting, the deeper GitLawb node path is there.

That gives the Work board a better answer than “an agent changed something.” It can point to the project, the task, the machine, and the proof trail behind the code.

GitLawb Integration

The full integration guide for CLI setup, local DID identity, project links, proof badges, Fleet Code Node status, and lazy node hosting.

Open GitLawb docs

Work Board Details

How project IDs and sanitized proof records move through tasks without leaking private vault paths, secrets, or machine details.

Open Work docs

Shared Brain

The shared brain is a normal Obsidian vault, not a proprietary database. HivemindOS writes durable state into that vault when available: Kanban records, notifications, scheduled runs, wallet records, shared skills, service notes, and reviewed outputs. Agent Memory supports entity-linked recall, canonical memory heads, temporal history, and soft retrieval telemetry; high-volume operational events stay in a separate bounded local journal and only become durable knowledge through review. QMD, GBrain, Neo4j, Syntho, and Trading Brain stay optional service layers around the vault.

Brain, Vault, And Skills

Obsidian vault routing, entity-linked memory, temporal recall, compiled wiki search, graph access, shared skills, QMD, Neo4j, GBrain, Syntho, Trading Brain, Synthesis, OKF export, and sync ownership.

Open brain docs

Shared Brain Benchmarks

Measured recall quality, authenticated API latency, scale, full-vault speedups, contradiction control, pattern precision, and live token reduction.

Open benchmark scorecard

Agent-Native Workflows

Action metadata, dashboard pins, Shared Brain review proposals, Context X-Ray manifests, and visual plan/recap artifacts.

Open workflow docs

Hive Fusion

Capability search plus skill authoring: turn a normal prompt into a reusable shared-brain skill built from the agents, apps, tools, and workflows the hive already has.

Open fusion docs

Packaged Skills

HivemindOS-owned Hive skills, third-party packaged skills, auto-install policy, optional catalog rules, and skill maintenance contracts.

Open packaged skills

Whole Brain

The separated GitHub Pages guide for vault structure, compiled knowledge, brain services, OKF exchange bundles, shared skills, sync health, and architecture sync rules.

Open whole brain

Hivemind Sync

The cross-machine route for shared brain files, shared env keys, and vault-backed handoff transfers.

Open sync docs

Env, Files, Notifications, And Maintenance

Shared env, runtime file browsing, notification storage, process telemetry, and conservative repair checks.

Open system docs

Token And Cost Savings

How shared brain recall, Hive skills, assimilation, fusion workflows, model routing, and usage analytics reduce repeated token spend.

Open savings docs

Economy And Integrations

Wallet and token features are explicit rails, not a background permission pool. Agent wallets handle controlled Base, Robinhood Chain, and Solana balances plus x402 paid requests, including HivemindOS Models calls paid directly from a local wallet without user API keys. The crypto capability router lets agents ask for intents such as paid API, private transfer, tokenized stock trade, or Bankr trading, then select or prepare the configured rail without executing spending itself. Hive Compute is an experimental marketplace inference and spare-GPU hosting path. Honey is one cumulative record of verified contribution and bounded recognition, Hivemind Cloud credits pay for managed service usage, and HIVE remains an optional community/payment rail. Integrations connect the control room to outside systems without making those systems own local state.

Wallets, Tokens, Honey, HIVE, And x402

Agent wallets, crypto rail routing, USDC/USDG sends, MoneyClaw, wallet-paid HivemindOS Models, wallet-vault backups, Honey contribution records, Hivemind Cloud credits, optional HIVE payment paths, and stock buying via Alpaca, Robinhood Agentic brokerage, xStocks, or Robinhood Chain Stock Tokens.

Open wallet docs

Agent-Analyzed Copy Trading

Pair an unchanged copy-trader with a GPT-5.6 Sol research twin, review each copied buy after execution, close rejected positions, and compare both returns through an EVO-ready sample gate.

Open copy-trading analysis docs

Hive Compute

Marketplace model inference, spare-GPU hosting, LM Studio or Ollama-backed job serving, x402 and MPP payment rails, and the hosted authority boundary for balances, payouts, and quotas.

Open compute docs

Managed Cloud Agents

Dedicated always-on Hermes agents with persistent workspaces, governed Base USDC funding, browser chat, and running or stopped metering.

Open cloud agent docs

App Builder And Web Hosting

Go from a prompt to a working app on your own machine or a managed agent, preview it locally, share a free 60-minute test build, and publish static or dynamic Sites on a stable HivemindOS URL.

Build and publish an app

HivemindOS Machines

Pre-initialized Azure Marketplace virtual machines in the user's own subscription, with transparent Microsoft billing for infrastructure and the HivemindOS software fee.

Open machine docs

Monetization

The free-vs-paid product boundary, including HivemindOS Cloud Agent Calls as a premium managed LiveKit feature.

Open monetization

Integrations And Work History

GitLawb Code Proof, app connections, GitHub OAuth, My Apps, API-service launchers, phone pairing, dynamic changelog, and work history.

Open integrations

Beeline Family Profiles

Separate family identities, explicit authority, allowed capability areas, and dedicated Chrome profiles without mixing them with your own account set.

Open Beeline

Agent Provider Integrations

External agent providers, MCP catalog discovery, Browser Use, OpenHands, Aider, n8n, Agentic Inbox, and Queen Bee PRD decomposition.

Open provider docs

Computer Interaction

Governed dashboard and browser operation with semantic-first routing, allowed domains and apps, fresh observations, consequence approvals, durable redacted receipts, and post-action verification.

Open computer interaction docs

Native And Background Surfaces

The browser and native app share the same Next.js UI. Tauri adds local filesystem and status helpers on This Mac, while AEON and Hermes keep their runtime-specific setup and background work docs separate.

Native App

Tauri development shell, packaged Next server, native status bridge, and desktop filesystem helpers.

Open native docs

AEON For Zero Human Companies

Choose a saved AEON workspace and skill as an optional company engine, understand the authority boundary, and monitor accepted handoffs without requiring a native crew.

Open the AEON company guide

AEON Brain Access

GitHub Actions tailnet brain access with visibility-scoped policy and OIDC-gated brain endpoint calls.

Open AEON docs

Hermes Local Setup

Local Hermes runtime setup notes for running interactive agent work beside the HivemindOS dashboard.

Open Hermes docs

Feature Map

flowchart TD
  Fleet["Fleet"] --> Runtimes["Agents and runtimes"]
  Fleet --> Apps["My Apps and API services"]
  Runtimes --> Chat["Chat"]
  Runtimes --> Phone["Phone calls"]
  Chat --> Work["Work board"]
  Chat --> XRay["Context X-Ray"]
  Work --> Scheduler["Scheduler"]
  Work --> LoopEngineering["Loop engineering"]
  LoopEngineering --> Evaluations["Agent evaluations"]
  Work --> VisualPlans["Visual plans and recaps"]
  Work --> Deliverables["Deliverables"]
  Work --> CodeProof["GitLawb Code Proof"]
  Work --> History["Work history"]
  Vault["Brain and vault"] --> Skills["Shared skills"]
  Vault --> ReviewQueue["Review queue"]
  Vault --> GBrain["GBrain"]
  Vault --> Syntho["Syntho / Synthesis"]
  Vault --> Notifications["Notifications"]
  Vault --> Env["Shared env"]
  Runtimes --> OpenClaw["OpenClaw"]
  Runtimes --> Evo["Evo optimization runs"]
  Runtimes --> MiroShark["MiroShark"]
  Runtimes --> AEON["AEON"]
  Work --> Companies["Zero Human Companies"]
  Companies --> AEON
  MiroShark --> Swarm["Swarm theater"]
  Runtimes --> Wallets["Wallets and tokens"]
  Wallets --> HiveCompute["Hive Compute payments"]
  Wallets --> TokenRails["Base / Solana / USDC"]
  Wallets --> Bankr["Bankr HIVE"]
  CodeProof --> Projects["Project registry"]
Expanded image Scroll to pan · Esc to close
100%