---
slug: "breenix"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/ryanbreen/breenix@main/README.md"
repo: "https://github.com/ryanbreen/breenix"
source_file: "README.md"
branch: "main"
---
# Breenix OS

An experimental x86_64 operating system written in Rust.

## Project Status

Breenix is a working OS with:
- UEFI/BIOS boot support
- Preemptive multitasking
- Userspace process execution
- Basic POSIX system calls
- Keyboard and timer drivers

**[📊 View Interactive Progress Dashboard](https://v0-breenix-dashboard.vercel.app/)** - Visual roadmap showing POSIX compliance progress across all subsystems.

See [docs/planning/PROJECT_ROADMAP.md](https://github.com/ryanbreen/breenix/blob/HEAD/docs/planning/PROJECT_ROADMAP.md) for detailed development status.

## Quick Start

```bash
# Run with QEMU (UEFI mode)
cargo run --bin qemu-uefi

# Run tests
cargo test

# Build with userspace programs
cargo build --features testing
```

## Documentation

- [PROJECT_ROADMAP.md](https://github.com/ryanbreen/breenix/blob/HEAD/docs/planning/PROJECT_ROADMAP.md) - Development roadmap and current status
- [CLAUDE.md](https://github.com/ryanbreen/breenix/blob/HEAD/CLAUDE.md) - Development practices and documentation guide
- [docs/planning/](https://github.com/ryanbreen/breenix/tree/HEAD/docs/planning/) - Detailed planning documents by phase