omarchy

Beautiful, Modern & Opinionated Linux

308 articles 35k View on GitHub ↗
308 articles
How to Create Menu Entries with Guards and Provider Functions in Omarchy

Learn to create dynamic Omarchy menu entries using when guards and action provider functions in omarchy-menu.jsonc. Build context-aware menus easily.

how-to-guide
Sep 13, 2026
How Omarchy Manages Version and Release Channels

Discover how Omarchy manages version and release channels using Bash utilities that inspect Pacman package state, parse mirrorlist comments, and detect Git metadata for development checkouts.

internals
Sep 13, 2026
How Omarchy Manages System Snapshots with Snapper: Complete Technical Guide

Learn how Omarchy uses Snapper for automated Btrfs snapshots before system updates. This guide covers retention policies and Limine bootloader restoration.

how-to-guide
Sep 13, 2026
Omarchy Boot System Components: mkinitcpio, Limine, and Plymouth Explained

Discover the Omarchy boot system components mkinitcpio, Limine, and Plymouth. Learn how these tools create a unified and graphical boot experience with custom hooks and scripts.

deep-dive
Sep 13, 2026
How the Omarchy Notification System Routes Messages: CLI to QML Architecture

Discover how the Omarchy notification system routes messages. Learn about the CLI to QML architecture and message persistence for desktop toasts.

internals
Sep 13, 2026
How Omarchy Integrates with Hyprland Using Shell Commands and IPC

Discover how Omarchy integrates with Hyprland using shell commands and IPC. Control workspaces, monitors, and layouts with simple commands like omarchy-toggle-bar and omarchy-refresh-config. Learn more now.

how-to-guide
Sep 13, 2026
How Feature Toggles Work with the toggle-* Command Prefix in Omarchy

Discover how Omarchy uses feature toggles with the toggle-* command prefix. Learn to manage feature flags efficiently via simple file presence in your state directory.

how-to-guide
Sep 13, 2026
How Omarchy Package Management Helpers Support Pacman and AUR: A Complete Guide

Learn how Omarchy package management helpers support Pacman and AUR with idempotent operations. This guide details our Bash wrappers for native Arch Linux tools.

how-to-guide
Sep 13, 2026
How to Use omarchy-debug and omarchy-upload-log for Omarchy Diagnostics

Master Omarchy diagnostics with omarchy-debug and omarchy-upload-log. Effortlessly gather system snapshots and logs for faster troubleshooting.

how-to-guide
Sep 13, 2026
How the Omarchy Update Process Pipeline Works: A Complete Technical Guide

Understand the omarchy update process pipeline. This guide details how the `omarchy update` command manages system updates, validation, package upgrades, and migrations securely.

deep-dive
Sep 13, 2026
How to Add User Hooks in Omarchy’s Config Directory: A Complete Setup Guide

Learn how to add user hooks in Omarchy's config directory. Follow our guide to place executable scripts or use the command for easy setup and permission management.

how-to-guide
Sep 13, 2026
How Omarchy Install Scripts and Finalize Scripts Function

Understand how Omarchy install scripts and finalize scripts function across three key phases: system installation, per-user finalization, and first-run graphical setup. Streamline your OS configuration.

how-to-guide
Sep 13, 2026
…

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →