How obstinix/pyxisos works
PyxisOS is a two-track operating-system project. The sampled runtime paths expose a working research-consensus CLI and prototypes for a native kernel; the README also documents an operational Arch-based desktop and management capabilities whose implementation files are not present in this tree. The main evidenced workflow accepts a query, routes it to agents, collects opinions, arbitrates a decision, and reports the result. Kernel and hardware components are shown as distinct runtime areas; unsampled wiring is omitted.
Main entry points: cli.ts Consensus CLI · decisionArbitrationLayer.ts Decision Arbitration · main.rs Lunar Core Entry · lib.rs Kernel Library
Components 32
Consensus Engine
- Consensus CLI
research/consensus/src/cli.ts - Agent Router
research/consensus/src/routing/router.ts - Agent Contract
research/consensus/src/agents/base.ts - Research Agent
research/consensus/src/agents/research.ts - Logic Agent
research/consensus/src/agents/logic.ts - Security Agent
research/consensus/src/agents/security.ts - LLM Provider
research/consensus/src/llm/provider.ts - Anthropic Adapter
research/consensus/src/llm/anthropicProvider.ts - Decision Arbitration
research/consensus/src/arbitration/decisionArbitrationLayer.ts - Audit Logger
research/consensus/src/audit/logger.ts
Kernel Runtime
- Task Scheduler
kernel/src/scheduler.rs - Task State
kernel/src/task.rs - IPC Channel
kernel/src/ipc.rs - Spinlock
kernel/src/sync.rs - Kernel FFI
kernel/src/ffi.rs - Kernel Library
kernel/src/lib.rs
Hardware and OS
- C Kernel Main
kernel/core/main.c - Userspace Shell
userspace/shell/shell.c - Virtual Filesystem
fs/vfs.c - RAM Filesystem
fs/ramfs.c - Memory Management
mm/vmm.c - Interrupt Handling
arch/x86_64/cpu/idt.c - Hardware Drivers
drivers/char/serial.c
Native Track
- Lunar Core Entry
native/lunar-core/src/main.rs - Native Boot
native/lunar-core/src/boot/mod.rs - Native Memory
native/lunar-core/src/memory/mod.rs - Native Logging
native/lunar-core/src/logging.rs - Native Panic
native/lunar-core/src/panic.rs - Aegis Sandbox
native/aegis/src/lib.rs
Other components
- Query User
- Decision Output
- Anthropic Service
Connections 27
- Query User → Consensus CLI: submits query
research/consensus/src/cli.ts - Consensus CLI → Agent Router: routes context
research/consensus/src/cli.ts - Consensus CLI → Research Agent: registers agent
research/consensus/src/cli.ts - Consensus CLI → Logic Agent: registers agent
research/consensus/src/cli.ts - Consensus CLI → Security Agent: registers agent
research/consensus/src/cli.ts - Agent Router → Agent Contract: accepts agents
research/consensus/src/routing/router.ts - Consensus CLI → Research Agent: dispatches analysis
research/consensus/src/cli.ts - Consensus CLI → Logic Agent: dispatches analysis
research/consensus/src/cli.ts - Consensus CLI → Security Agent: dispatches analysis
research/consensus/src/cli.ts - Research Agent → LLM Provider: sends prompt
research/consensus/src/agents/research.ts - Consensus CLI → Decision Arbitration: arbitrates opinions
research/consensus/src/cli.ts - Decision Arbitration → LLM Provider: requests synthesis
research/consensus/src/arbitration/decisionArbitrationLayer.ts - Decision Arbitration → Audit Logger: logs opinions
research/consensus/src/arbitration/decisionArbitrationLayer.ts - Decision Arbitration → Audit Logger: logs outcome
research/consensus/src/arbitration/decisionArbitrationLayer.ts - Decision Arbitration → Decision Output: returns decision
research/consensus/src/arbitration/decisionArbitrationLayer.ts - LLM Provider → Anthropic Adapter: implemented by
research/consensus/src/llm/anthropicProvider.ts - Anthropic Adapter → Anthropic Service: calls API
- Task Scheduler → Task State: updates tasks
kernel/src/scheduler.rs - Task Scheduler → Spinlock: guards scheduler
kernel/src/scheduler.rs - IPC Channel → Spinlock: guards channel
kernel/src/ipc.rs - Kernel Library → Task Scheduler: exports module
kernel/src/lib.rs - Kernel Library → IPC Channel: exports module
kernel/src/lib.rs - Kernel Library → Kernel FFI: exports module
kernel/src/lib.rs - Lunar Core Entry → Native Logging: initializes logging
native/lunar-core/src/main.rs - Lunar Core Entry → Native Boot: declares module
native/lunar-core/src/main.rs - Lunar Core Entry → Native Memory: declares module
native/lunar-core/src/main.rs - Lunar Core Entry → Native Panic: declares module
native/lunar-core/src/main.rs