The OS is the agent interface.
An agent-native, immutable Linux — purpose-built for human-AI collaboration.

chaossynergy.dev

Chaossynergy is a Bluefin LTS derivative — an agent-native, immutable Linux operating system built on CentOS Stream 10.

Two windows. A browser. An agent. Connected at the protocol level.

# Build the OS image (30 sec — we build FROM not INCEPT)
just build-chaossynergy stable

# Build a QCOW2 VM image
just build-qcow2 stable

Or pull from the registry:

sudo bootc switch ghcr.io/dark5un/chaossynergy:stable
sudo systemctl reboot

A thin overlay on Bluefin LTS:

FROM ghcr.io/projectbluefin/bluefin-lts:stable
COPY chaos_files/ /tmp/chaos/
RUN bash /tmp/chaos/build.sh

The overlay adds:

• herdr — agent-native terminal multiplexer, fullscreen on boot
• user-setup — first-login automation (pass init, wallpaper, terminal theme)
• branding — Chaossynergy wallpaper, icon, Anaconda identity
• recovery — Shift-at-boot root shell
• ujust recipes — on-demand agent and inference setup

All agents live in their own distrobox containers (per ADR-004). Install on demand with ujust:

Inference engines are mutually exclusive (both fight for VRAM). Switching engines stops the other automatically.

# Start local inference with llama
ujust setup-inference-llama

# Switch to vLLM (stops llama first)
ujust setup-inference-vllm

# Switch quant on llama (Q4_K_M ↔ Q8_0)
ujust inference-model

# Use it in Hermes
hermes model set custom:local-llama/bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M

The inference container has GPU access via nvidia-container-toolkit and runs as a systemd user service for persistence.

┌────────────────────────────────────────────────────────┐
│  Bluefin LTS (CentOS Stream 10)                        │
│  ┌──────────────────────────────────────────────────┐  │
│  │  Chaossynergy overlay                             │  │
│  │  ├── herdr (fullscreen terminal on boot)         │  │
│  │  ├── user-setup (first login automation)         │  │
│  │  ├── branding (wallpaper, icon)                  │  │
│  │  ├── recovery (Shift-at-boot root shell)         │  │
│  │  ├── ujust/chaossynergy.just                     │  │
│  │  │   (agents + inference recipes)                │  │
│  │  └── ADR-011/012 (local inference, toolchain)    │  │
│  └──────────────────────────────────────────────────┘  │
│  ┌──────────────────────────────────────────────────┐  │
│  │  Distrobox containers (on-demand via ujust)       │  │
│  │  ├── hermes    (first-boot, orchestration)       │  │
│  │  ├── opencode  (coding agent)                    │  │
│  │  ├── pi        (Pi coding agent)                 │  │
│  │  ├── claude    (Claude Code)                     │  │
│  │  └── inference (llama.cpp or vLLM)               │  │
│  └──────────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────────┘

Architecture Decision Records live in chaos_files/docs/adr/. Key records:

Apache 2.0

Chaossynergy stands on the shoulders of giants:

• Bluefin LTS — the CentOS Stream 10 immutable OS foundation.
• Hermes Agent — the open-source AI agent framework by Nous Research.
• herdr — the agent-native terminal multiplexer.
• CentOS Stream — the enterprise-grade Linux base.
• bootc — bootable container technology.
• Browser MCP — AI-to-browser MCP extension.
• pass — the standard Unix password manager.
• Chromium — the open-source browser.