The desktop of the network // early access

bromigOS™The Wick on your desk.

Holograms and a caretaker who lives on your desktop, worlds that move with your machine, widgets that show real readings. A layer of signed packages on Arch Linux and Hyprland, with one command to install, theme, update and roll back.

Phases done: 3/5
Packages: 12
Worlds: 9

Get bromigOS See what it does

Highlight 01

Holograms and VECTOR.

A caretaker of relay light who lives on your desktop, and holographic models and decks you can call up over any window. Drag one to turn it.

VECTOR's brain is any OpenAI-compatible endpoint you choose: a local model, one in your homelab, or a hosted one. His voice runs on your machine, and his memory stays there.

Mire, live on the bromigOS desktop: Mire on the bromigOS desktop, rendered offscreen from the live layer: the stilt shack and its keeper at his line, the Sleepers risen for working agents, fireflies for network traffic, a heron for a notification — **Mire** · rendered offscreen from the live layer

Highlight 02

Live worlds.

The scene behind your windows is a world of the Drift, and everything that moves in it is real data: your agents, your network, your notifications, the clock.

The keeper mirrors you: working while you work, dozing when you're idle. If a source isn't there, the thing it drives isn't drawn. Nothing moves for decoration.

Choose a world

What feeds the worlds

What feeds the worlds
Source	What it is	Comes from
Agents	AI coding agents run by herdr: working, needs you, finished	herdr
Agents working	herdr's working agents, plus busy Claude Code sessions outside herdr	herdr, the process list
Network	Throughput, split into download and upload	this machine
Notifications	Desktop notifications, with critical ones flagged	this machine
CPU	This machine's load	this machine
Activity	Whether you're working, idle or locked	this machine
Lab health	Your homelab's services: up, degraded or down	`bromigos-homelab`
Local models	How hard your homelab's local models are working	`bromigos-homelab`
Clock	Local time; the moon's phase is computed from it	this machine

**The widgets in Wick** · rendered offscreen from bromigOS

Highlight 03

Widgets that do things.

Translucent plates that show real readings only, where every region explains itself on hover. A unified menu on SUPER + SPACE runs everything else.

The panels · 9

The panels
Panel	Shows	On by default
`system`	CPU and threads, a load waterfall, memory, video memory, the GPU, uptime	Yes
`network`	The interface, a traffic scope, and a latency radar to the hosts you list	Yes
`storage`	The mounted filesystems and how full they are	Yes
`workbench`	Your recent Git repositories and most-visited folders	Yes
`notes`	Field notes, a notepad that saves as you type	Yes
`shortcuts`	Every key binding, read from Hyprland	Yes
`weather`	The forecast for a place you choose	No
`connections`	Network connections, Wi-Fi and VPNs	No
`lab`	Your homelab at a glance, and any panels you declare	With `bromigos-homelab` and a configured homelab

Highlight 04

Your homelab's console.

Cluster health, GitOps, metrics, local models, secrets status and agents, live on the desktop and to VECTOR. Read-only by design: nothing reads a secret, and nothing is sent anywhere you didn't configure.

metrics
hosts
workloads
deployments
models
agents
secrets
ci
alerts
voice
media
gpus
logs
routes
certs
ddns
network
storage
apps
games
library
runners
packages
backups
ocr

Adapters · 42

Adapters
Type	Provides
prometheus	metrics, hosts, alerts
victoriametrics	metrics, hosts, alerts
alertmanager	alerts
kubernetes	workloads (pods), hosts (nodes)
docker	workloads (containers), hosts
argocd	deployments
flux	deployments
litellm	models
ollama	models
openai	models
vault	secrets
herdr	agents
github	ci
lab	snapshot, hosts
gnosis	knowledge
bromigos-voice	voice
comfyui	media
proxmox	hosts (nodes), workloads (VMs and containers)
netdata	metrics, hosts
dcgm	gpus
loki	logs, apps
alloy	apps
dozzle	apps, with a link to read logs in
traefik	routes
cert-manager	certs
ddns	ddns
unifi	network
s3	storage, apps
nas	storage
redis`,` dragonfly	apps
neo4j	apps
open-webui`,` searxng	apps
workload	apps
vllm	models
ocr	ocr, apps
pelican	games
arr	library
jellyfin`,` plex	library
arc	runners
pacman-repo	packages
backups	backups
pbs	backups

**Mire, layer by layer** · its painting split into depth for the live layer

Highlight 05

Make a world.

A world's art is data, like its colours: a recipe for every painting, creature and loop. The art command says what's made and what's missing, then makes it where you choose: this machine, your homelab, or a hosted service only if you allow it.

themeA theme folder: colors.toml, theme.toml, backgrounds, maybe a world
live-deckA deck: one .py file defining DECK
live-layerA shader layer: <name>.frag and its .json
widgetA panel: one .py file with a panels.Panel subclass
vector-toolA VECTOR plugin whose register(vector) adds tools
vector-memoryA VECTOR plugin whose register(vector) adds a memory store
vector-skillA skill: <name>.md, or a folder with a SKILL.md
homelab-adapterA registry.Adapter for one kind of service
commandAn executable named bromigos-<group>[-<name>]
hookAn executable run after every bromigos theme set

Highlight 06

Make it yours.

One install command for anything bromigOS can be extended with: themes, decks, shader layers, widgets, VECTOR's tools and skills, homelab adapters, commands and hooks. An update shows what changed and asks first.

Your plugin folders

Your plugin folders
Folder	What goes there
`~/.config/bromigos/plugins/live/`	Python modules that join the live layer's `live` package, such as module decks
`~/.config/bromigos/plugins/live/decks/`	Deck plugins: `<name>.py` files defining `DECK`, reloaded when they change
`~/.config/bromigos/plugins/live/layers/`	Shader layers: `<name>.frag` plus `<name>.json`
`~/.config/bromigos/plugins/widgets/`	Panels: `<name>.py` files defining a `panels.Panel` subclass
`~/.config/bromigos/plugins/settings/`	Settings pages: `<name>.py` files defining `PAGE`
`~/.config/bromigos/plugins/homelab/`	Homelab adapters

Roadmap · as of 2026-10-09

Layer first. Distro second.

bromigOS ships as a layer on vanilla Arch first, and as an ISO once the layer is solid.

Phase 01 · Complete
Carve out the shareable desktop
The desktop carved out of one machine into signed pacman packages, with updates and migrations.
Phase 02 · Complete
Install on a fresh Arch machine
A short bootstrap and a first-run setup take a fresh Arch install to the full desktop.
Phase 03 · Complete
The ISO
A live and install medium that boots straight into the desktop: encrypted, with snapshots in the boot menu.
Phase 04 · In progress
Hardware and polish
The unified menu, the theme switcher, extensions from git; then laptops, GPUs and accessibility.
- The shell
- Themes beyond the desktop
- Safety and docs
- Extensions
- Hardware
- Peripheral modules
- Accessibility
- Settings, and idle and lock
- The Settings overhaul
- The shortcut picker
- The boot menus
Phase 05 · In progress
The lab console
- Part 1: the console
- Part 2: changing the lab
- Part 3: setting up a new lab

Ready to light it?

bromigOS is in early access, and anyone can install it. The installer is a short script you can read before you run it.

Get bromigOS Choose your world first

Generated from bromigOS · bromigOS@4b30a91 · vector@67f98a8

Arch Linux is a trademark of its owners; bromigOS is not affiliated with Arch Linux.

bromigOS™The Wick on your desk.

Holograms and VECTOR.

Live worlds.

Widgets that do things.

Your homelab's console.

Make a world.

Make it yours.

Carve out the shareable desktop

Install on a fresh Arch machine

The ISO

Hardware and polish

The lab console

Ready to light it?