Omarchy

Plan, validate, and apply Linux desktop configuration changes via Omarchy.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Omarchy provides a structured framework to safely plan, validate, and apply changes to Linux desktop configurations to prevent breaking the system.

Core Features & Use Cases

  • Enforces best-practice workflows for editing Hyprland, Waybar, Walker, and terminal config files under ~/.config, ensuring changes are intentional and recoverable.
  • Guides users through safety rules, change scope, and roll-back procedures, including read-only areas like ~/.local/share/omarchy/.
  • Supports centralized discovery and application of config changes via the Omarchy command set and theme/monitor/display tooling.

Quick Start

Describe the desired config change and follow the guided prompts to perform a safe, validated update.

Frequently Asked Questions about Omarchy

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

FAQPage Schema
How do I safely manage Hyprland and Waybar configuration changes in Linux?

Safely manage Hyprland and Waybar configuration changes by using a centralized framework to plan, validate, and apply edits to ~/.config/* files. This prevents breaking the Linux desktop system by enforcing intentional and recoverable workflows.

What is the best way to roll back Linux desktop configuration updates?

The best way to roll back Linux desktop configuration updates is through guided safety rules and change scope procedures. This approach ensures you can revert modifications to terminal config files and related desktop settings while maintaining system stability.

Can I modify files in the ~/.local/share/omarchy/ directory directly?

You cannot modify files in the ~/.local/share/omarchy/ directory directly because it is a read-only area. Configuration changes must be applied through the Omarchy command set to ensure safe, centralized administration of system configurations.

Does this configuration management approach support Walker and terminal configs?

Yes, this configuration management approach supports Walker and terminal config files. It enforces best-practice workflows for safely editing these specific applications within your ~/.config directory.

How do I apply theme and monitor display tooling changes without breaking my system?

To apply theme and monitor display tooling changes without breaking your system, use centralized discovery and application commands. This validates updates to your Linux desktop configuration before they are fully applied.