Understand the
whole machine.
Start with the dated status snapshot to see what is actually verified. Repository documents remain authoritative and evolve with the code; future architecture is not the same as current functionality.
Desktop preview
Boot controls, real terminal/files, graphics ABI, input safety and QEMU pixel tests.
Read on GitHub ↗ PORT PLAN / NOT RUNNINGChromium gates
Concrete native runtime requirements and acceptance tests. No browser port is claimed.
Read on GitHub ↗ 29 SEP 2026Development status
Native desktop preview, real guest captures, exact-head evidence and explicit remaining work.
Read the snapshot → DOCOverview
Project identity, current status, architecture and quick start.
Read on GitHub ↗ DOCRoadmap
Scoped milestones and evidence, from boot through persistent USB and self-hosting.
Read on GitHub ↗ DOCSecurity roadmap
Security goals and remaining hardening work, not a security certification.
Read on GitHub ↗ DOCContributing
How to contribute to Vibrix.
Read on GitHub ↗ DOCAgent instructions
Required primary-source research, evidence, authorship and integration rules.
Read on GitHub ↗ DOCArchitecture
System architecture and component boundaries.
Read on GitHub ↗ DOCBoot ABI
Firmware-to-kernel handoff and BootInfo contract.
Read on GitHub ↗ DOCMemory
Memory design and verified foundations.
Read on GitHub ↗ DOCUnsafe boundaries
Invariants around low-level unsafe Rust.
Read on GitHub ↗ DOCACPI
Firmware table discovery and constraints.
Read on GitHub ↗ DOCPCI / ECAM
PCI enumeration and bounded PCIe ECAM reads.
Read on GitHub ↗ DOCUSB model
Persistent removable-device architecture.
Read on GitHub ↗ POLICYDependencies
Allowed libraries, reviewed Git sources, licensing, feature graphs and scan limits.
Read on GitHub ↗ DOCIndependence
Own architecture, useful external libraries, no copied OS implementation.
Read on GitHub ↗ DOCQEMU
Development boot, controls and emulator workflow.
Read on GitHub ↗ VALIDATIONCI and evidence
Locked audits, target checks, QEMU probes, artifacts and required-check setup.
Read on GitHub ↗ DOCHost testing
Host tests and their limits relative to production/hardware proof.
Read on GitHub ↗ DOCEarly heap
The bounded early kernel heap contract.
Read on GitHub ↗ HOST TOOLGPT image creation
Safe regular-file image creation.
Read on GitHub ↗ HOST TOOLGPT inspection
Read-only partition-table validation.
Read on GitHub ↗ RESEARCHAI contributions
How to research, compare, implement, test and credit a contribution.
Read on GitHub ↗ ADRArchitecture decisions
ADR index and compatibility/design rationale.
Read on GitHub ↗Architecture Decision Records
Major choices deserve primary-source research and explicit tradeoffs: address spaces, load layout, page tables, firmware lifetimes, USB identity, transitions and subsystem contracts.
Browse all ADRs ↗