HivemindOS manual
Current AEON Control Plane
HivemindOS can operate a current AEON checkout from the Autopilot view or directly from chat. Link or clone the official aeonfun/aeon repository, open the agent, and use the Control tab for runtime-wide configuration—or type /aeon in Chat.
The workspace may live on this Mac or on another linked HivemindOS machine. Status, skills, schedules, runs, logs, outputs, memory, document edits, and safe repository updates are performed on the machine that owns the workspace, while the controls stay the same in HivemindOS.
AEON is optional. HivemindOS still works with native crews and other runtimes when no AEON workspace is configured. When you do use AEON, its own workspace and command-line control plane remain the authority for AEON skills, configuration, schedules, runs, logs, and outputs. That authority applies to the linked AEON workspace—not to unrelated HivemindOS features.
The Autopilot view is an operator interface over that authority. Actions such as enabling a skill, changing a schedule, selecting a model, or installing an MCP server are sent through AEON’s own control plane and validation. HivemindOS does not keep a second competing copy of those settings.
Navigate The Autopilot View
| Tab | What you can do |
|---|---|
| Overview | See whether the workspace is working, scheduled, paused, or idle, plus recent performance and next actions. |
| Work | Browse the current skill catalog, run a skill now, put it on duty, pause it, or create an automation with a cadence, brief, and model. |
| Activity | Review AEON-only run history, open real run logs, and inspect recent outputs without unrelated repository jobs mixed in. |
| Deliverables | Preview artifacts and hand them to another machine through HivemindOS. |
| Control | Manage model, harness, gateway, packs, MCP servers, Strategy, Soul, health evidence, provenance, and Telegram delivery. |
| Settings | Check workspace compatibility, sync skills and required keys, update or save the repository, inspect memory, and control the Obsidian mirror. |
Work, Automations, And Activity
The Work tab reads the skills AEON actually discovers in the linked workspace. Each skill shows its current duty state, schedule, model, description, source, and declared credential or MCP requirements where available.
From this tab you can:
- run a manual skill immediately
- put a skill on duty, pause it, or resume it
- create an automation without editing YAML or GitHub Actions by hand
- choose a cadence, operating brief, and model override for that skill
- stop the on-duty automations in the selected workspace
The Activity tab uses AEON’s filtered run history rather than the repository’s entire automation history. Open a run to see its real status, conclusion, summary, and logs. Outputs and handoff-ready artifacts remain attached to the selected AEON workspace.
Control Tab
- choose AEON’s default agent engine, model, and connection. The current choices are Claude, Grok, Codex, Pi, Vibe, and Kimi; each shows only its compatible models
- browse first-party and community skill packs
- add featured MCP servers and remove configured servers
- read, write, or generate the Strategy document
- build the agent’s Soul and Style documents
- review chain definitions and artifacts, reactive rules, and provenance attestations
- review self-healing health records and native OKF knowledge-bundle readiness
- register Telegram delivery using AEON’s credential-safe flow
- inspect the exact credential names declared by skills without exposing values
- verify whether the linked workspace matches the audited upstream source and supports
/aeon, multiple agent engines, privileged-action auditing, failure cutoffs, preview runs, conditional automations, event validation, and workspace self-updates
Community packs and MCP servers extend what the workspace can execute. Review their source, requested credentials, and external side effects before installing or enabling them.
Settings, Sync, And Memory
The Settings tab shows whether the current workspace has its configuration, CLI, and skill catalog. It also shows repository changes and whether the local checkout is ahead of or behind its remote.
From Settings you can:
- sync the Shared Brain skill library into AEON
- sync only the credential names required by the active harness, gateway, and enabled skills
- update the workspace from GitHub or save current changes to GitHub
- review AEON topics, logs, and issue memory
- start, stop, or run the Obsidian mirror once
Secret values are never returned to the panel. The UI shows credential names and set, shared, local, or missing status so you can configure access without exposing the value.
Use AEON As A Company Engine
A Zero Human Company can use one linked AEON workspace and one runnable skill as its optional autonomy engine. This is a company-level binding: HivemindOS keeps the charter, apex goal, launch and stop controls, freeze state, and company Runs record, while AEON owns the detailed background execution.
In this mode:
- a native HivemindOS company crew is optional
- the company editor offers only saved AEON workspaces and skills currently discovered there
- the binding is checked again when the company dispatches
- queued or active work in the selected workspace prevents overlapping company dispatches
- company Runs records the accepted handoff, then closes it only after HivemindOS observes one exactly matched terminal AEON run
- a completed or failed company run includes a direct link back to that matched AEON run when AEON provides one
- detailed logs and outputs stay in the Autopilot view
See Use AEON With Zero Human Companies for the complete operator walkthrough and Zero Human Companies for the full company cockpit.
When you open Talk to CEO for an AEON-backed company, /aeon resolves the company’s saved AEON profile and skill before the operator turn. Edits to its schedules, skills, Strategy, Soul, agent engine, model, or credential readiness therefore affect the same workspace used by the next autonomous company cycle. The command does not silently change the company binding.
Workspace requirements
A compatible workspace contains:
aeon.yml- the
apps/cli/aeonlauncher (or a rootaeonlauncher) catalog/skills.json- a
skills/directory
HivemindOS no longer creates an empty AEON-shaped folder. Initialize clones the official aeonfun/aeon repository, while Link validates the selected checkout. An older incompatible workspace is reported as legacy and must be updated or re-cloned.
Artifacts and evidence
HivemindOS discovers current AEON artifacts in output/articles/, output/images/, output/.chains/, output/.attest/, and apps/dashboard/outputs/. Older output folders remain readable during migration, but new work follows the v0.1 layout.
Run logs come from AEON’s filtered run history, so the Activity tab excludes unrelated repository CI. The Deliverables tab can preview evidence and hand it to another machine through HivemindOS, including when the AEON workspace belongs to a linked machine.
Shared Brain skills and credentials
Shared Brain skills are copied into the checkout’s skills/ directory. AEON v0.1 discovers them from their SKILL.md files; HivemindOS does not create the removed root skills.json manifest.
Credential sync is allowlisted from the active harness/gateway’s core authentication choices plus requirements declared by enabled skills and AEON’s secret catalog. Selecting a single missing key syncs only that key. Secret values stay in local/shared credential stores and GitHub secrets; the dashboard receives names and set/missing state only.
Updating an older workspace
If the AEON status says legacy:
- Commit or back up any work you want to keep in the old repository.
- Update the checkout from its upstream if it can fast-forward cleanly, or clone a fresh official AEON repository.
- Reapply custom skills as folders under
skills/. - Link the updated checkout in HivemindOS.
- Open Control and confirm the CLI, catalog, Strategy/Soul, packs, and MCP inventory load successfully.
HivemindOS intentionally refuses to manufacture missing v0.1 files because a partial workspace looks connected but cannot run AEON correctly.