How burning-ice420/agentic-os works
Agentic-OS is a workspace spanning a bare-metal interactive OS, a reusable asynchronous HiveMind kernel/API, a desktop observer, and a VM/mesh service. The OS workflow runs from boot into shell and desktop interaction, with state held in Hive memory and persisted through disk/VFS; agents and an LLM accelerator provide reactive and delegated cognition. The README only names the product, so capability detail comes from the sampled source and SOURCE INDEX; unsampled subsystem links are omitted where their callers are unclear.
Main entry points: shell.rs Interactive shell · mod.rs Memory graph · persist.rs Hive persistence · api.rs Kernel API
Components 27
Bare-metal OS
- OS boot runtime
hivemind/hivemind-os/src/main.rs - Interactive shell
hivemind/hivemind-os/src/shell.rs - Desktop UI
hivemind/hivemind-os/src/desktop.rs - Memory graph
hivemind/hivemind-os/src/hive/mod.rs - Blob values
hivemind/hivemind-os/src/hive/blob.rs - Memory nodes
hivemind/hivemind-os/src/hive/memory_node.rs - Reactive agents
hivemind/hivemind-os/src/agent/mod.rs - LLM accelerator
hivemind/hivemind-os/src/llm.rs - Serial mesh
hivemind/hivemind-os/src/net/mod.rs - ATA disk driver
hivemind/hivemind-os/src/disk/mod.rs - Hive persistence
hivemind/hivemind-os/src/disk/persist.rs - RAM filesystem
hivemind/hivemind-os/src/vfs/mod.rs - Interrupt and ticks
hivemind/hivemind-os/src/interrupts.rs
HiveMind Kernel
- Kernel API
hivemind/hivemind-kernel/src/api.rs - Async Hive graph
hivemind/hivemind-kernel/src/hive.rs - Kernel agents
hivemind/hivemind-kernel/src/agent.rs - Kernel blobs
hivemind/hivemind-kernel/src/blob.rs - Kernel memory
hivemind/hivemind-kernel/src/memory.rs
Observer UI
- Observer application
hivemind/hivemind-observer/src/main.rs - Graph view
hivemind/hivemind-observer/src/graph_view.rs - Graph layout
hivemind/hivemind-observer/src/layout.rs - Detail sidebar
hivemind/hivemind-observer/src/sidebar.rs
VM and Mesh
- VM service API
hivemind/hivemind-vos/src/api.rs - VM manager
hivemind/hivemind-vos/src/vm.rs - VM mesh bridge
hivemind/hivemind-vos/src/mesh_bridge.rs
Other components
- OS user
- QEMU process
Connections 36
- OS user → Interactive shell: enters commands
hivemind/hivemind-os/src/shell.rs - OS boot runtime → Interactive shell: starts runtime
hivemind/hivemind-os/src/main.rs - OS boot runtime → Desktop UI: starts UI
hivemind/hivemind-os/src/main.rs - OS boot runtime → Memory graph: initializes state
hivemind/hivemind-os/src/main.rs - Interactive shell → Memory graph: reads and mutates
hivemind/hivemind-os/src/shell.rs - Interactive shell → Reactive agents: configures agents
hivemind/hivemind-os/src/shell.rs - Interactive shell → LLM accelerator: requests inference
hivemind/hivemind-os/src/shell.rs - Interactive shell → RAM filesystem: uses filesystem
hivemind/hivemind-os/src/shell.rs - Interactive shell → Hive persistence: marks state dirty
hivemind/hivemind-os/src/shell.rs - Desktop UI → Memory graph: reads and mutates
hivemind/hivemind-os/src/desktop.rs - Desktop UI → RAM filesystem: uses filesystem
hivemind/hivemind-os/src/desktop.rs - Memory graph → Blob values: stores values
hivemind/hivemind-os/src/hive/mod.rs - Memory graph → Memory nodes: creates nodes
hivemind/hivemind-os/src/hive/mod.rs - Reactive agents → Memory graph: watches blobs
hivemind/hivemind-os/src/agent/mod.rs - Reactive agents → LLM accelerator: delegates decisions
hivemind/hivemind-os/src/agent/mod.rs - Reactive agents → Serial mesh: uses mesh
hivemind/hivemind-os/src/agent/mod.rs - Hive persistence → ATA disk driver: reads and writes
hivemind/hivemind-os/src/disk/persist.rs - Hive persistence → Memory graph: serializes state
hivemind/hivemind-os/src/disk/persist.rs - Hive persistence → RAM filesystem: serializes filesystem
hivemind/hivemind-os/src/disk/persist.rs - Hive persistence → Interrupt and ticks: checks tick
hivemind/hivemind-os/src/disk/persist.rs - Interrupt and ticks → Interactive shell: forwards keys
hivemind/hivemind-os/src/interrupts.rs - Kernel API → Async Hive graph: dispatches operations
hivemind/hivemind-kernel/src/api.rs - Kernel API → Kernel agents: dispatches operations
hivemind/hivemind-kernel/src/api.rs - Kernel API → Kernel blobs: uses blob types
hivemind/hivemind-kernel/src/api.rs - Kernel API → Kernel memory: dispatches operations
hivemind/hivemind-kernel/src/api.rs - Async Hive graph → Kernel agents: manages agents
hivemind/hivemind-kernel/src/hive.rs - Async Hive graph → Kernel blobs: stores blobs
hivemind/hivemind-kernel/src/hive.rs - Async Hive graph → Kernel memory: stores memories
hivemind/hivemind-kernel/src/hive.rs - Observer application → Graph view: renders graph
hivemind/hivemind-observer/src/main.rs - Observer application → Graph layout: uses layout
hivemind/hivemind-observer/src/main.rs - Observer application → Detail sidebar: renders details
hivemind/hivemind-observer/src/main.rs - Graph view → Graph layout: positions graph
hivemind/hivemind-observer/src/graph_view.rs - VM service API → VM manager: dispatches VM actions
hivemind/hivemind-vos/src/api.rs - VM service API → VM mesh bridge: dispatches mesh actions
hivemind/hivemind-vos/src/api.rs - VM mesh bridge → VM manager: uses VM state
hivemind/hivemind-vos/src/mesh_bridge.rs - VM manager → QEMU process: starts and stops
hivemind/hivemind-vos/src/vm.rs