Omarchy

Manage Omarchy Linux configurations and workflows under ~/.config.

Updated Jan 11, 2026
One-click install
npx skills add https://github.com/mlaurel/omarchy --skill omarchy-mlaurel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Omarchy
Source: https://github.com/mlaurel/omarchy/tree/main/default/omarchy-skill
Command: npx skills add https://github.com/mlaurel/omarchy --skill omarchy-mlaurel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Omarchy management of Linux systems requires careful handling of config changes across multiple components. This skill provides structured guidance and safe workflows to edit and manage user configurations in ~/.config and Omarchy's related tooling, reducing risk and cognitive load.

Core Features & Use Cases

  • Centralized control of Omarchy configuration and command workflows across Hyprland, Waybar, Walker, and terminal configs.
  • Safe defaults, reset and migration guidance, and hooks for automation to enforce consistency.
  • Clear decision framework for development and troubleshooting, including debugging and safe-apply patterns.

Quick Start

Safely apply a recommended configuration change to Hyprland or related Omarchy components.

Frequently Asked Questions about Omarchy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely change Hyprland configuration files in Omarchy without breaking the system?

To change Hyprland configuration in Omarchy safely, edit files under ~/.config while avoiding writes to ~/.local/share/omarchy/. The system enforces safety constraints and provides structured guidance for applying changes.

What is the best way to manage Waybar and Walker settings on a Linux system running Hyprland?

The best way to manage Waybar and Walker settings is through Omarchy's centralized control workflows. It provides standard configuration locations and safe-apply patterns specifically for these components.

Can I use omarchy commands to automate terminal configs and system themes?

Yes, you can automate terminal configs and themes using ~145 omarchy-<category>-<action> commands. These commands support configuring themes, hooks, and safety rules across your system.

Why should I avoid writing to the ~/.local/share/omarchy directory when editing configs?

You should avoid writing to ~/.local/share/omarchy because the system enforces strict safety constraints to protect internal data. Editing is restricted to ~/.config to reduce risk and cognitive load.

How do I reset or migrate Omarchy Linux settings when troubleshooting?

To reset or migrate Omarchy Linux settings, use the skill's provided reset and migration guidance. It offers clear decision frameworks for troubleshooting and safe-apply patterns to ensure consistency.

Does Omarchy support hooks for automating Linux desktop environment workflows?

Yes, Omarchy supports hooks for automation to enforce consistency across Hyprland and related tooling. These hooks integrate with the standard configuration locations and command workflows.