Omarchy: DHH's distro that became an agentic operating system

Video summary: this article is based on the video “Omarchy Agentic OS — This Changes EVERYTHING For AI-Native Founders”, from the channel Simon Høiberg, and goes beyond it with the project's official documentation.
Video URL: https://www.youtube.com/watch?v=JjjecbwrioA

A SaaS founder installs a Linux distribution, asks an AI agent to reconfigure the system's own shortcuts and window rules, reloads the environment, and continues working within the version the agent just customized. His reaction in the video is: “I want to build my entire company within this”.

The distro is Omarchy, and it is today the loudest phenomenon in Linux desktop. This post explains what it actually is, where it came from, how to install, the first steps that matter — and where the excitement deserves a brake.

What is Omarchy

Omarchy is a Linux distribution omakase based on Arch Linux, in the tiling window manager Hyprland and in the desktop build kit Quickshell. “Omakase” is the Japanese term for “chef's choice”: the chef puts together the menu, but you can always return a dish. Translating to software — the decisions already come made, and you reconfigure whatever you want afterward.

It's not just a handful of pre-installed packages. It comes with an entire thought-out system: Neovim, Chromium, Obsidian, LibreOffice, Kdenlive, OBS Studio, a bunch of TUIs and even a Winamp-style music player. The thesis, in the creator's own words, is that a beautiful system is a motivating system, and productivity comes after motivation.

Project numbers today: repository omacom/omarchy, , MIT, written mostly in Shell, with almost 39 thousand stars and more than 4 thousand forks. The latest version at the time of this post (September 2026) is 4.0.2, from the series nicknamed Quattro.

Where it came from: DHH, Omakub, and a love letter to Linux

The creator is David Heinemeier Hansson — the DHH: creator of Ruby on Rails, partner at 37signals (Basecamp, HEY), and in recent years, one of the most vocal critics of public cloud dependency.

The repository was created on June 1st, 2025. In the announcement, DHH described the project as “my latest love letter to Linux” and was honest about the audience: the Omarchy didn't replace Omakub, his Ubuntu setup — was a sibling project, because Ubuntu is a softer landing for outsiders than Arch. In 2026 things changed: Omakub was retired and had its repositories archived. Anyone wanting the same idea about Ubuntu should look at the community fork, Omabuntu.

The problem it solves has a name: Hyprland is wonderful and comes completely barebones from the factory. You have to figure out on your own how to have a lock screen, idle timer, menu bar, Bluetooth panel. Omarchy is the answer to that — a set of good and beautiful defaults, plus all the tools you'd normally install.

2026: when the personal project became an institution

What started as a developer's dotfiles turned into something else in 2026:

• Omarchy Quattro (4.0) — released in August of 2026, crossed 100 thousand ISO downloads in one week and 200 thousand in 18 days: on average, a new ISO every 8 seconds, with a peak of 1.165 downloads in one hour.
• Omacom Foundation — nonprofit foundation announced on 21/08/2026 with US$ 8 million, which reached US$ 14,95 million in commitments until 3 September 2026 — of which US$ 1,95 million is not money, but rather token credit donated by Meta Superintelligence Labs, Anthropic, OpenAI and Fireworks. Among the twelve Founding Patrons (US$ 1 million each) are Drew Houston (Dropbox) and Peter Steinberger (creator of OpenClaw); 1Password and 37signals joined as Distinguished Corporate Patrons, with US$ 100 thousand per year for three years each.
• Money returning to the ecosystem — the foundation became exclusive sponsor of Hyprland (Vaxry) and primary sponsor of Quickshell sponsor of mise (jdx), and made their first full-time hire: kernel developer Krzysztof Wilczyński, to work on the Omarchy kernel.
• Plugin marketplace — thousands of community plugins (there were 500 in August of 2026, when the first competition took place), with competitions and prizes.
• Structure — a formalized Core Team, ~35 thousand members on Discord, meetups around the world, and a “Rangers” program to help people coming from macOS and Windows.

It's worth noting what this means: a distro just over a year old is funding three of the upstream projects it depends on. That's rare and it's good.

The video's point: the “agentic OS”

What hooked Simon Høiberg wasn't the window mosaic. He was already running most of his company operations with AI agents — a code agent on a dedicated server, another monitoring infrastructure, another triaging support tickets — and he had built his own harness (which he calls OpsLayer) plus an Electron app and another in React Native just to have a place to see and control all of it.

When installing Omarchy, his conclusion was that he was rebuilding in Electron something the operating system already delivered natively. The agent inspected the system configuration, manipulated shortcuts and window rules, reloaded the environment, and continued working within the modified version.

He also raises the most important self-criticism from the video, and it deserves highlighting: all of this can become the perfect excuse for a technical founder to spend months improving the productivity system and avoid the actual business. Before AI was the perfect workspace in Notion, the “second brain,” the Zapier flow. The criterion he proposes is simple and applies to you: the system has to help you do more, improve the work, or make the work more pleasant — preferably all three.

How AI is actually embedded

This is where the official documentation surpasses the video. Omarchy doesn't choose a favorite agent for you: all major agent CLIs come pre-connected as stubs managed by mise in ~/.local/bin/, with lazy loading — nothing is downloaded until you run it for the first time.

Command	Agent
claude	Claude Code
codex	OpenAI Codex
opencode	OpenCode
copilot	GitHub Copilot CLI
grok	Grok CLI (xAI)
crush	Crush
agy	Google Antigravity CLI
ori	Ori, the OpenRouter harness
pi	Pi, o harness de Mario Zechner
omp	Oh My Pi

Você escolhe o padrão com omarchy default agent <nome> (ou em Setup > Defaults > Agent no menu). Depois disso, Super + Shift + Ctrl + A lança o agente padrão numa janela de terminal dedicada — ou abre o seletor, se você ainda não escolheu nenhum. Também dá para lançar já com uma tarefa:

omarchy agent prompt "Revise este projeto"

Leia esta frase duas vezes: agentes lançados por esse caminho rodam em modo não pergunte, faça. Eles vão realmente mexer nas coisas. Por segurança, como os agentes se recusam a confiar no diretório home inteiro, lançamentos a partir de $HOME começam em ~/Work.

Três integrações merecem menção:

• Painel de agentes na barra — aparece quando o sistema detecta uso de agente na máquina, e concentra plano, percentual consumido dos limites de 5 horas e semanal, e consumo de tokens por dia e por modelo. Os dados são regenerados a cada 15 minutos.
• Diagnóstico de crash — o Omarchy vigia o systemd-coredump. Quando algo dá segfault, você recebe uma notificação; clicando nela, o core dump é entregue ao agente junto com uma skill que o orienta a levantar os fatos e decidir se vale reportar upstream. Dá para silenciar por programa com omarchy crash mute hyprland.
• A skill do Omarchy — uma habilidade instalada nos diretórios de skill do Claude Code, Codex, Pi e Antigravity, que ensina o agente a mexer no Hyprland, na barra e nos temas. A própria documentação a classifica como experimental e recomenda rodar em modo de planejamento primeiro, com omarchy reinstall configs na manga caso o agente faça bagunça.

Installing

A instalação é por ISO, e o projeto se orgulha do tempo: menos de um minuto nas máquinas mais rápidas, dificilmente mais de cinco num computador antigo.

1. Baixe a ISO in omarchy.org e confira o SHA-256 e a assinatura publicados ao lado do arquivo.
2. Grave num pendrive — no Linux, use o caligula; no Mac ou Windows, o balenaEtcher.
3. Desligue Secure Boot e/ou TPM na BIOS. Não é opcional: sem isso a instalação não roda.
4. Escolha o tipo de instalação — disco inteiro (apaga tudo: se o disco não estiver vazio, faça backup before) ou espaço livre, que é como se faz o dual boot com Windows. No caso do dual boot, desative o BitLocker no Windows antes.
5. Responda cinco perguntas e assista à instalação.

Três detalhes que evitam dor de cabeça:

• Use teclado com fio ou dongle 2.4 GHz. A instalação vem com criptografia de disco por padrão, e teclado Bluetooth não funciona na tela de senha do boot — mesmo motivo pelo qual ele não funciona na BIOS.
• Instalando para outra pessoa? Aperte Ctrl + C na primeira tela (seleção de teclado) e o instalador prepara a máquina para outro dono: o sistema instala na hora, mas teclado, usuário e senha ficam para o primeiro boot — e a senha que a pessoa escolher vira a senha de criptografia.
• Sem criptografia — para instalações descartáveis ou máquinas remotas protegidas, Ctrl + C na confirmação de formatação alterna para o modo sem criptografia. Para qualquer notebook que possa ser perdido ou roubado, não faça isso.

Existe ainda a instalação desatendida, em que a ISO se instala sozinha lendo a configuração de um segundo drive — é o caminho para usar o Omarchy como imagem base de VMs e de frota.

First steps: the shortcuts that matter

O primeiro comando a memorizar é Super + K, que lista todos os atalhos. Depois dele, esses são os que você vai usar no primeiro dia:

Atalho	O que faz
Super + Space	Menu do Omarchy — apps, configurações, instalar software, quase tudo
Super + Return	Abre o terminal
Super + Shift + Return	Abre o navegador
Super + W or Super + Q	Fecha a janela
Super + Seta	Move o foco para a janela naquela direção
Super + Shift + Seta	Troca a janela de lugar com a vizinha
Super + 1/2/3/4	Pula para a área de trabalho
Super + Shift + 1/2/3/4	Manda a janela para aquela área de trabalho
Super + T	Alterna a janela entre mosaico e flutuante
Super + F	Tela cheia
Super + Escape	Menu de sistema (suspender, reiniciar…)
Super + Ctrl + L	Bloqueia o computador
Super + Ctrl + V	Histórico da área de transferência (com imagens)
Super + Shift + Ctrl + A	Lança o agente de IA padrão

Coming from macOS or Windows

A tradução mental é mais simples do que parece — e o manual tem um capítulo inteiro só para isso:

• Tudo gira em torno do Super (a tecla Windows). O reflexo do Spotlight, do Raycast ou do menu Iniciar vira Super + Space.
• Não existe dock nem ícone na área de trabalho. Aplicativos abrem por atalho ou pelo menu. A única interface permanente é a barra do topo, e quase todo widget dela faz coisas diferentes com clique esquerdo, direito e do meio.
• As janelas se posicionam sozinhas. Abra uma e ela ocupa a tela; abra a segunda e elas dividem o espaço. Você nunca mais pesca uma janela debaixo da outra, porque elas não se sobrepõem. Esse é o choque de mentalidade — e vale insistir nele antes de sair jogando tudo para flutuante com Super + T.
• Copiar e colar funcionam em todo lugar, inclusive no terminal: Super + C and Super + V — o recortar, Super + X, vale fora do terminal. Nada de reflexo separado para o shell.

Updates, channels, and snapshots

Este é o ponto onde o Omarchy mais se afasta de “só um monte de dotfiles”. Ele se instala como pacotes pacman de um repositório próprio, e a atualização é um processo, não um comando solto:

omarchy update     # ou o alias: mup

Isso instala a nova versão, roda as migrações pendentes para deixar sua configuração em dia e atualiza os pacotes do sistema pelo mirror Arch do projeto. Quando há release nova, um ícone de seta circular aparece ao lado do relógio.

Não rode pacman -Syu neither yay -Syu direto. Você perderia o snapshot, as migrações e as atualizações de configuração — e o Omarchy inclusive barra a atualização direta e te aponta para o comando certo.

São quatro canais: stable (padrão; o mirror roda um mês atrás do Arch, de propósito, para pegar incompatibilidades antes de você), RC, edge (Arch mais recente, só para quem sabe recuperar um sistema quebrado) e dev (aponta para um checkout git em ~/omarchy). Troca-se em Update > Channel ou com omarchy-channel-set.

E toda atualização gera um snapshot Btrfs automaticamente. Se algo quebrar, você reinicia e escolhe o snapshot anterior no bootloader Limine:

omarchy-snapshot create     # snapshot manual
omarchy-snapshot restore    # restaurar de dentro do snapshot inicializado

Duas ressalvas importantes: a restauração devolve o sistema de arquivos raiz, não o seu /home — serve para reverter atualização quebrada, não para recuperar arquivo pessoal. E o recurso só existe em instalações com Limine, padrão desde o Omarchy 2.0.

A CLI omarchy

Quase tudo o que o menu faz também está numa CLI — que é justamente o que torna o sistema tratável por um agente:

omarchy                      # lista todos os comandos e grupos
omarchy update               # atualizar Omarchy e pacotes
omarchy theme list           # listar temas
omarchy theme set tokyo-night
omarchy font list
omarchy screenshot
omarchy debug                # informações de diagnóstico

Os grupos cobrem agent, audio, bar, bluetooth, brightness, capture, channel, clipboard, config e uma lista longa de outros. Trocar de tema, aliás, reestiliza o sistema inteiro de uma vez — terminal, barra, notificações e papel de parede — e há mais de vinte temas oficiais, de Catppuccin a Gruvbox, Nord e Tokyo Night.

Is it worth it? The honest part

O entusiasmo do vídeo é legítimo, mas um post técnico deve o outro lado ao leitor:

• “É mesmo uma distro?” A briga existe e o próprio vídeo a menciona: parte da comunidade Linux argumenta que o Omarchy é sobretudo um conjunto de configurações sobre o Arch, e que DHH recebe crédito por trabalho de empacotamento sobre projetos alheios. É uma crítica justa em espírito — mas hoje o projeto tem ISO própria, repositório de pacotes, mirror, migrações, snapshots e bootloader configurado. Passou faz tempo do estágio de dotfiles.
• É Arch, e Arch é rolling release. O canal stable atrasado em um mês reduz o risco, mas não o elimina. Você está optando por um sistema que muda o tempo todo.
• Desligar Secure Boot é um custo real. Aceite conscientemente, não por acidente.
• Agente com aprovação automática mexendo no seu sistema é uma faca de dois gumes. A documentação é explícita: a skill é experimental, rode em modo de planejamento antes e tenha o caminho de rollback à mão. Um agente que erra o hyprland.conf te deixa sem desktop.
• Curva de aprendizado. Tiling window manager não é um tema bonito para o seu desktop atual: é outra forma de usar o computador. Duas semanas até os dedos aprenderem é normal.

Para quem passa o dia no terminal, escreve código e gosta de teclado, o Omarchy é provavelmente a maneira mais rápida que existe hoje de ter um Hyprland completo e bonito sem passar duas semanas montando um. Para quem quer um desktop que simplesmente fique parado no lugar, Ubuntu ou Fedora continuam a resposta certa.

Closing

O que o Omarchy acerta não é o mosaico de janelas — é assumir que o computador voltou a ser maleável e entregar as ferramentas para moldá-lo, seja pelas suas mãos ou pelas de um agente. A parte agêntica ainda é experimental e você deve tratá-la como tal. O resto já está maduro o bastante para virar sua máquina de trabalho.

Para continuar por aqui: veja como rodar IA local no Linux com Ollama (o próprio manual do Omarchy recomenda LM Studio e Ollama para modelos locais), conheça os AI assistants on the Linux terminal, a mesma família de CLIs que a distro já deixa pré-conectada, e leia sobre vibe coding no Linux com skills de IA no CLI.

Official links: omarchy.org · manual · guia de instalação · github.com/omacom/omarchy