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.
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.
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 FleetFleet Machine Permissions
Collector-only machines, per-capability Allow/Ask/Deny controls, master-hub authority, approval handoffs, and CPU/RAM/storage routing limits.
Open machine permissionsAgents, 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 agentsLocal 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 readerCapability 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 approvalsCalling
Dashboard and mobile agent calls, BYOK Realtime by default, speaker-only fallback, phone pairing, and paid LiveKit/SFU cloud rooms.
Open calling docsLooped 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 docsWork 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 docsLoop Engineering
Pattern registry, readiness levels, budgets, receipts, human gates, and exportable loop snapshots for bounded autonomous work.
Open loop docsAgent 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 docsAgent Challenges
Bounded multi-agent objectives with public challenge boards, credited lineage, per-agent run caps, verifier rulings, significance thresholds, and shared playbooks.
Open challenge docsQuant 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 docsMiroShark 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 docsEvo 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 docsCode 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 docsWork Board Details
How project IDs and sanitized proof records move through tasks without leaking private vault paths, secrets, or machine details.
Open Work docsShared 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 docsShared Brain Benchmarks
Measured recall quality, authenticated API latency, scale, full-vault speedups, contradiction control, pattern precision, and live token reduction.
Open benchmark scorecardAgent-Native Workflows
Action metadata, dashboard pins, Shared Brain review proposals, Context X-Ray manifests, and visual plan/recap artifacts.
Open workflow docsHive 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 docsPackaged Skills
HivemindOS-owned Hive skills, third-party packaged skills, auto-install policy, optional catalog rules, and skill maintenance contracts.
Open packaged skillsWhole 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 brainHivemind Sync
The cross-machine route for shared brain files, shared env keys, and vault-backed handoff transfers.
Open sync docsEnv, Files, Notifications, And Maintenance
Shared env, runtime file browsing, notification storage, process telemetry, and conservative repair checks.
Open system docsToken And Cost Savings
How shared brain recall, Hive skills, assimilation, fusion workflows, model routing, and usage analytics reduce repeated token spend.
Open savings docsEconomy 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 docsAgent-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 docsHive 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 docsManaged Cloud Agents
Dedicated always-on Hermes agents with persistent workspaces, governed Base USDC funding, browser chat, and running or stopped metering.
Open cloud agent docsApp 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 appHivemindOS 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 docsMonetization
The free-vs-paid product boundary, including HivemindOS Cloud Agent Calls as a premium managed LiveKit feature.
Open monetizationIntegrations And Work History
GitLawb Code Proof, app connections, GitHub OAuth, My Apps, API-service launchers, phone pairing, dynamic changelog, and work history.
Open integrationsBeeline Family Profiles
Separate family identities, explicit authority, allowed capability areas, and dedicated Chrome profiles without mixing them with your own account set.
Open BeelineAgent Provider Integrations
External agent providers, MCP catalog discovery, Browser Use, OpenHands, Aider, n8n, Agentic Inbox, and Queen Bee PRD decomposition.
Open provider docsComputer 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 docsNative 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 docsAEON 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 guideAEON Brain Access
GitHub Actions tailnet brain access with visibility-scoped policy and OIDC-gated brain endpoint calls.
Open AEON docsHermes Local Setup
Local Hermes runtime setup notes for running interactive agent work beside the HivemindOS dashboard.
Open Hermes docsFeature 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"]