Inside ChrisOS

An operating system, a language, and the tools to build both. From the first instruction to the desktop.

SOURCE EDITION: main @ da3df29 · 26 SEP 2026

System map¶

                         ChrisOS
                            │
           ┌────────────────┼────────────────┐
           │                │                │
        Kernel           ChrisC           ChrisFS
           │                │                │
   metal / drivers     compiler + CLVM    persistence
           │                │                │
           ├──── graphics ──┼──── apps ──────┤
           │                │                │
      VirtIO / VirGL       JIT          Desktop / Tools
           │
       real hardware

Reading paths¶

Goal	Start	Continue
Run the project	Build & run	Boot → desktop → validation
Understand the OS	System architecture	Memory → interrupts → processes → ChrisFS
Write programs	ChrisC	CLVM → libraries → IDE → native toolchain
Understand the GPU	2D graphics	Software 3D → VirtIO-GPU → VirGL → shaders
Follow self-hosting	Self-hosting	Native toolchain → installation → roadmap

Current source baseline¶

This GitHub Pages edition tracks the ChrisOS main branch. The current migration baseline is commit da3df29, replacing the earlier Sites snapshot that was tied to feat/os2 @ 252b92e.

KERNELx86-64 higher-half, memory, interrupts, processes

LANGUAGEChrisC + CLVM + JIT + native toolchain work

GRAPHICSsoftware path + VirtIO-GPU + reusable VirGL backend

STORAGEChrisFS and multiple block-device paths