How ai-operatingsystem293/aios works
AIOS is a Rust-based operating system for coordinating independent AI agents. Its documented user workflow runs from an interactive command through the Master Agent, planning and task-graph scheduling, concurrent workers, capability-based agent selection, then recovery, verification, aggregation and a response. The graph also includes plugin loading, the external SDK, agent-generation tools and kernel event/service infrastructure. Workflow links follow the README; source excerpts confirm selected registry, plugin, planning, recovery and verification behavior. Several runtime stages were not excerpted, so their links rely on README documentation.
Main entry points: kernel.rs AIOS Kernel · pool.rs Worker Pool · master.rs Master Agent · registry.rs Agent Registry
Components 21
User Interface
- Interactive CLI
src/cli/shell.rs - Command Dispatcher
src/command/dispatcher.rs
Orchestration
- Master Agent
src/master/master.rs - Goal Planning
src/planner - Task Graph
src/task/graph.rs - Task Scheduler
src/task/scheduler.rs - Recovery Engine
src/recovery/engine.rs - Verification Engine
src/verification/engine.rs - Result Aggregator
src/aggregator/aggregator.rs
Agent Execution
- Worker Pool
src/runtime/pool.rs - Agent Registry
src/kernel/registry.rs - Capability Providers
src/capability/provider.rs - Built-in Agents
src/agents/math.rs
Agent Extensions
- Dynamic Plugin Manager
src/plugin/manager.rs - External Agent SDK
sdk/src/agent.rs - Agent Generator
src/devtools/generator.rs
Kernel Services
- AIOS Kernel
src/kernel/kernel.rs - Event Bus
src/event/bus.rs - Memory Service
src/memory/memory.rs - Service Manager
src/service/manager.rs
Other components
- User
Connections 24
- User → Interactive CLI: enters commands
README.md - Interactive CLI → Command Dispatcher: forwards commands
README.md - Command Dispatcher → AIOS Kernel: dispatches requests
src/command/dispatcher.rs - AIOS Kernel → Master Agent: executes goals
src/kernel/kernel.rs - Master Agent → Goal Planning: analyzes goals
README.md - Goal Planning → Task Graph: builds dependencies
README.md - Task Graph → Task Scheduler: supplies ready tasks
README.md - Task Scheduler → Worker Pool: dispatches tasks
README.md - Worker Pool → Agent Registry: finds agents
README.md - Agent Registry → Capability Providers: registers providers
src/kernel/registry.rs - Agent Registry → Built-in Agents: registers and executes
src/kernel/registry.rs - Capability Providers → Goal Planning: informs plan selection
src/planner/engine.rs - Worker Pool → Recovery Engine: recovers failures
README.md - Worker Pool → Verification Engine: submits outputs
README.md - Verification Engine → Result Aggregator: validates results
README.md - Result Aggregator → Master Agent: returns combined results
README.md - Master Agent → Interactive CLI: returns response
README.md - AIOS Kernel → Dynamic Plugin Manager: loads dynamic agents
src/kernel/kernel.rs - Dynamic Plugin Manager → Agent Registry: registers loaded agents
src/plugin/manager.rs - External Agent SDK → Built-in Agents: defines agent interface
README.md - Agent Generator → External Agent SDK: generates agent templates
README.md - AIOS Kernel → Event Bus: initializes event listeners
src/kernel/kernel.rs - AIOS Kernel → Memory Service: provides memory service
src/kernel/kernel.rs - AIOS Kernel → Service Manager: registers services
src/kernel/kernel.rs