Omarchy

Enforce guardrails and backups for Omarchy configuration edits on Linux.

Updated Dec 4, 2025
One-click install
npx skills add https://github.com/aidansunbury/docs-agent --skill omarchy-aidansunbury
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Omarchy
Source: https://github.com/aidansunbury/docs-agent/tree/main/resources/omarchy/default/omarchy-skill
Command: npx skills add https://github.com/aidansunbury/docs-agent --skill omarchy-aidansunbury

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage Omarchy configurations across Linux environments safely by enforcing guardrails, centralized guidance, and recovery workflows that prevent risky edits to user config and system defaults.

Core Features & Use Cases

  • Guarded configuration edits across Omarchy-related directories (Hyprland, Waybar, Walker, and terminal configs)
  • Clear safety rules, backups, and reset procedures to minimize misconfigurations
  • Command discovery and structured usage patterns for automation and AI-assisted workflows

Quick Start

Review the Omarchy safety rules before editing any ~/.config/omarchy settings and perform a conservative refresh to verify changes.

Frequently Asked Questions about Omarchy

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

FAQPage Schema
How do I safely manage Omarchy Linux configurations without breaking Hyprland or Waybar?

Safely manage Omarchy Linux configurations by enforcing guardrails, backups, and reset workflows across Hyprland, Waybar, Walker, and terminal configs to prevent risky edits.

What is the best way to recover from a misconfigured Hyprland or Waybar setup?

Recover from a misconfigured Hyprland or Waybar setup using built-in reset workflows and backups that restore previous Omarchy configuration states.

How does frontmatter-driven configuration management work for Linux desktop environments?

Frontmatter-driven configuration management organizes Linux desktop environment tasks into structured Skill units with optional resource directories, enabling safe on-demand edits.

Can I automate terminal config edits across Omarchy directories without risking system defaults?

Automate terminal config edits across Omarchy directories safely using enforced guardrails and structured command discovery patterns that protect system defaults.

What are the limitations when applying guardrails to Walker and terminal configurations?

Guardrails for Walker and terminal configurations apply strictly to Omarchy-related directories, meaning edits outside these paths or ignoring backup workflows may lack safety enforcement.