For years, setting up Arch Linux with a custom Hyprland tiling desktop was a rite of passage and a fast track to days trapped in dotfile hell.

Then David Heinemeier Hansson (DHH), creator of Ruby on Rails, ditched macOS and decided to tackle the problem with Omarchy.

Built on an "omakase" (chef's choice) philosophy, Omarchy bundles Arch Linux, Wayland, Hyprland, and a unified Quickshell desktop into a 2-minute automated install. It bills itself as the first true "agentic OS," allowing you to vibe-code desktop widgets in QML with AI models and feed system crashes directly to coding agents like OpenAI Codex or Claude Code.

I spent the last couple of days daily-driving Omarchy.

Do you prefer watching instead? Check the full breakdown video here:

The Omarchy Keyboard & Shortcuts Cheat Sheet

Omarchy is pretty much keyboard-first and mouse second. Ditching the mouse is jarring at first, so keep these essential keybindings under your fingers (Super represents the Windows key or Mac Command key):

  • System & Launchers:

    • Super + Space: Open the master Omarchy menu to search apps, modify settings, or install packages.

    • Super + K: Pull up the interactive keybindings cheat sheet overlay.

    • Super + Return: Launch the default terminal.

    • Super + Shift + Return: Launch the web browser.

    • Super + Shift + F: Open the default file manager.

    Window & Workspace Management:

    • Super + W: Close the active focused window.

    • Super + [Arrow Keys]: Shift focus between active tiled Hyprland windows.

    • Super + [1-4]: Jump directly between workspaces 1 through 4.

    • Super + Shift + [1-4]: Move the focused window directly to a target workspace.

    The Scratchpad Workflow:

    • Super + Alt + S: Move the active window to the scratchpad.

    • Super + S: Toggle the scratchpad.

    Themes & Built-in Utilities:

    • Super + Ctrl + Shift + Space: Open the system theme switcher.

    • Super + Ctrl + V: Clipboard manager.

    • Super + Ctrl + E: Emoji picker.

    Agent Diagnostics:

    • omarchy agent crash <PID>: Hands a recorded crash to your configured AI agent for diagnosis.

The Verdict: Who Is Omarchy Actually For?

  • The Good: Instant visual polish, zero dotfile drift during system updates, and lightning-fast tiling. Vibe-coding custom status bar widgets in QML with AI prompts works remarkably well.

  • The Bad: Unapologetically opinionated. If you rely on mouse navigation or traditional floating windows, you will fight the system constantly. Granting autonomous agents passwordless sudo privileges also introduces genuine security and hallucination hazards.

The Bottom Line

If you are a terminal-heavy software developer or power user looking for a pre-configured, hyper-productive Arch Linux environment without the maintenance headaches, Omarchy is an absolute breath of fresh air. If you prefer traditional point-and-click desktops, stick with Fedora KDE.

For more tech and AI breakdowns, check out my YouTube channel HERE.