omarchy

Omarchy is described as a beautiful, fun and agentic Linux distribution created by DHH. The repository's main content is its manual, kept in the `manual/` directory as the authoritative source and mirrored to learn.omacom.io, where screenshots are hosted. The manual is organized into several sections. The Basics covers getting started, migrating from Mac or Windows, navigation, the top bar, themes, hotkeys, a unified clipboard with history, reminders, notices, text extraction and dictation, screenshots and recording, toggles/idle/screensaver behavior, and the Omarchy CLI. The Applications section documents the terminal, Neovim, AI tooling, development tools, shell tools and shell functions, TUIs, GUIs, browsers, commercial apps and services, web apps, gaming, filling out PDFs, a Windows VM, and other packages. Configuration topics include updates, dotfiles, shell plugins, monitors, keyboard/mouse/trackpad, networking, system sleep, hardware authentication, fonts, backgrounds, prompt, branding, common tweaks, and instructions for making your own theme. The remaining chapters cover Mac support, troubleshooting, FAQ, system snapshots, security, running Omarchy on various hardware, dual boot installation, and unattended installs. The project is released under the MIT License. The README itself is primarily an index of documentation rather than a technical specification, so details about the underlying desktop environment, package set, or installation mechanics are found in the linked manual chapters rather than the repository description.