basecamp/omarchy
Summary
Omarchy is a modern, opinionated Linux distribution created by DHH, featuring a comprehensive manual and integration with development tools and AI.
View Cached Full Text
Cached at: 08/16/26, 03:33 PM
basecamp/omarchy
Source: https://github.com/basecamp/omarchy
Omarchy
Omarchy is a beautiful, modern & opinionated Linux distribution by DHH.
Read more at omarchy.org.
The Omarchy Manual
The manual lives in manual/, which is its authoritative source. It’s
mirrored to learn.omacom.io, where
its screenshots are also hosted.
The Basics
- Getting Started
- Coming From Mac or Windows
- Navigation
- The top bar
- Themes
- Hotkeys
- Unified Clipboard & History
- Reminders
- Notices
- Text Extraction & Dictation
- Screenshots & Recording
- Toggles, idle & screensaver
- Omarchy CLI
The Applications
- Terminal
- Neovim
- AI
- Development Tools
- Shell Tools
- Shell Functions
- TUIs
- GUIs
- Browsers
- Commercial apps/services
- Web Apps
- Gaming
- Filling out PDFs
- Windows VM
- Other Packages
Configuration
- Updates
- Dotfiles
- Shell plugins
- Monitors
- Keyboard, Mouse, Trackpad
- Networking
- System sleep
- Hardware authentication
- Fonts
- Backgrounds
- Prompt
- Branding
- Common tweaks
- Extra themes
- Making your own theme
The Rest
- Mac support
- Troubleshooting
- FAQ
- System snapshots
- Security
- Omarchy on…
- Dual Boot Install
- Unattended Installs
License
Omarchy is released under the MIT License.
Similar Articles
@dhh: Omarchy is now all grown up! It's moved out from its incubation under basecamp/ on GitHub. The Omacom Foundation is the…
Omarchy, a Linux distribution by David Heinemeier Hansson (DHH), has moved from incubation under Basecamp to become an independent project under the Omacom Foundation on GitHub.
Omarchy
Omarchy is a malleable Linux desktop OS designed for the age of AI agents, offering a keyboard-first workstation with integrated coding agents for easy setup and customization.
@interjc: Omarchy China Station https://zh.omarchy.org
Omarchy is a Linux distribution featuring smart agents, customizable plugins, and integrated development tools designed to streamline system setup and maintenance.
omarchy is not a distro
A critical blog post argues that omarchy, DHH's Linux distribution, is not a real distro but merely his personal dotfiles on top of Arch Linux, bundled with proprietary software and personal keybindings.
@markfenner: I’ve been running Ubuntu on my second machine for over a decade. After seeing another breakdown of Omarchy, this time f…
The author announces their switch from Ubuntu to Omarchy after being impressed by its features, including AI agent integration and rapid customization, as showcased by NetworkChuck.