HivemindOS manual
Brain, Memory, And Skills
The Brain view is where you manage the knowledge and reusable capabilities behind Hive Superbrain. It gives permitted agents a shared place to find source material, recall reviewed decisions, reuse skills, and continue coordinated work.
The foundation is a normal Obsidian vault. You can open it yourself, read the same Markdown files your agents use, back it up, and sync it with tools you trust.
Start with the complete Hive Superbrain guide. This page focuses on what to do in the Brain view.
Add Source Material
Use Feed the brain in Brain to add text, files, or folders. You can also drag supported documents onto the vault view.
HivemindOS converts supported documents locally into readable Markdown and keeps the source name and import information with the note. This makes the material searchable without requiring you to upload the original file to a conversion service.
Choose the scope based on how long the context should last:
- Attach a file in Chat when it matters only to that conversation.
- Feed it to Brain when agents should be able to find and reuse it later.
- Add a company data room when the sources belong to one Zero Human Company and should appear in that company’s cockpit.
Imported text is evidence, not authority. Instructions inside a PDF, webpage, email, or old company handbook do not become standing agent commands merely because the file entered the brain.
Ask With Shared Context
You normally do not need a special memory command. Ask your question in Chat. HivemindOS looks for a small amount of relevant reviewed memory and source knowledge, then gives it to the selected agent.
Useful examples include:
- “What did we decide about the launch order?”
- “Use our usual review process on this change.”
- “Continue the project from the latest approved plan.”
- “Which provider is already set up for this capability?”
The agent should distinguish what it found from what it is inferring. If no reliable memory supports the answer, it should say so rather than inventing continuity.
Review Durable Memory
Not every chat message becomes permanent memory. When you or an agent proposes something worth keeping—a decision, preference, instruction, commitment, lesson, or stable project fact—it can wait for review before joining durable Agent Memory.
Review proposals for:
- whether the statement is actually durable;
- whether its scope is clear;
- whether it contains private data that does not belong in a shared note;
- whether it updates an older memory rather than creating a contradiction.
When reviewed truth changes, Hive Superbrain keeps the evolution history and treats the latest approved version as current. Removing a conversation does not require deleting an unrelated durable memory that was separately reviewed, but deleting a memory should remove it from active recall and its generated indexes.
Browse The Vault And Graph
The vault browser lets you open shared notes and approved files. The graph helps you explore links between notes, memories, projects, people, skills, and compiled knowledge.
Use the graph to investigate relationships, not as proof that every nearby item is relevant. A direct source note or reviewed memory is stronger evidence than visual proximity alone.
Use Shared Skills
A skill is a reusable procedure an agent can load when a task matches it. Shared skills live in the vault so compatible agents can discover the same way of working across runtimes and machines.
From the skill browser you can inspect installed skills, add an optional pack, review where a skill came from, update it, or remove it. Installing a skill makes instructions available; it does not run the workflow or approve its side effects.
Use Hive Fusion when you want to turn a successful process into a new shared skill. Review and test the result before treating it as a trusted team standard.
Keep Credentials Separate
Hive Superbrain can remember that a setup key exists and whether it is configured. Plaintext values live in Shared Env outside the Obsidian vault.
This separation makes setup discoverable without turning a synced note folder into a secret store. It also lets one approved setup become a default across permitted agents and trusted machines while a specific project can still override that value locally.
Open Shared Env for setup-once credentials and Hivemind Sync for cross-machine behavior.
Optional Brain Services
HivemindOS can add deeper search, compiled knowledge, graphs, and specialist knowledge services around the vault. They live under the Brain view’s Add-ons tab. These are optional layers, not a replacement for your files.
Most users can leave them on their recommended defaults. If a service is unavailable, the brain should fall back to the supported vault and memory path rather than making your notes unreadable. The advanced Memory and Brain Services guide explains what each service adds.
Common actions available from the Add-ons tab:
- Install or connect QMD. This adds another way to search a large vault. Generated search files stay in a local cache outside your vault, which receives only a short service note.
- Build compiled knowledge from research you have already reviewed, when you want a curated topic reference instead of raw notes.
- Connect a separate graph database when you want relationship queries outside Obsidian. Your vault stays the source of truth.
Each layer can be turned off again, and turning one off does not remove your notes.
What You Own
- Your Obsidian vault remains readable without HivemindOS.
- You choose which machines receive the shared vault.
- You review what becomes durable memory.
- You can inspect, edit, back up, export, and delete the underlying notes.
- Secrets remain outside normal notes and responses.
- Generated indexes can be rebuilt from the source material; they are not the only copy of your knowledge.
Next: learn the complete Superbrain, add documents, or manage shared skills.