omarchy

Name: omarchy
Availability: InStock
Author: okw0204

Guide safe customization of Omarchy configuration files in ~/.config/.

Updated Mar 10, 2026

Search Tags:#safety #linux #config-management #waybar #hyprland #omarchy

Ready to run

npx skills add https://github.com/okw0204/dotfiles --skill omarchy-okw0204

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: omarchy
Source: https://github.com/okw0204/dotfiles/tree/main/dot_config/opencode/skills/omarchy
Command: npx skills add https://github.com/okw0204/dotfiles --skill omarchy-okw0204

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps end users customize Omarchy-installed systems by guiding safe edits to user-focused config directories, while preventing changes to read-only internal source trees.

Core Features & Use Cases

Guided safe editing of ~/.config/* (Hyprland, Waybar, Walker, terminal configs, omarchy) with explicit safety caveats.
Enforces best practices for resets and backups via omarchy-refresh commands.
Provides a decision framework for whether a change should be applied directly, via themes, or via hooks.

Quick Start

Read the safety guidelines and edit your ~/.config files using the recommended practices, then apply changes with the appropriate omarchy-* commands.

Frequently Asked Questions about omarchy

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

FAQPage Schema

How do I safely customize Hyprland and Waybar configurations in Omarchy?▼

To safely customize Omarchy, edit user-focused config files within ~/.config/omarchy/ and related directories, then apply changes using omarchy-refresh commands to avoid modifying the read-only internal source tree.

What is the best way to apply Omarchy configuration changes without breaking the system?▼

The best way to apply Omarchy configuration changes safely is by using omarchy-refresh commands for resets and backups, ensuring you only edit ~/.config/* files and never modify ~/.local/share/omarchy/.

Can I directly modify the internal source tree to change Walker and terminal settings?▼

No, you cannot directly modify the internal source tree. You must use a decision framework to apply changes directly, via themes, or via hooks by editing ~/.config/ files instead of read-only source directories.

When do I need to use omarchy-refresh commands for config management?▼

You need to use omarchy-refresh commands when you want to enforce best practices for resets and backups after editing your Hyprland, Waybar, Walker, or terminal configurations in ~/.config/omarchy/.

Why should I refrain from editing ~/.local/share/omarchy/ files?▼

You should refrain from editing ~/.local/share/omarchy/ because it contains the read-only internal source tree; modifying it breaks safe config management workflows and prevents proper Omarchy customization.

Does Omarchy config management support applying changes via themes and hooks?▼

Yes, Omarchy config management provides a decision framework to determine whether a change should be applied directly, via themes, or via hooks to safely implement user preferences for Hyprland and Waybar.