omarchy

Guide safe edits to Omarchy Linux user config files with reset commands.

24.4k|2.5k|Updated Jun 1, 2025
One-click install
npx skills add https://github.com/basecamp/omarchy --skill omarchy-basecamp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omarchy
Source: https://github.com/basecamp/omarchy/tree/main/default/omarchy-skill
Command: npx skills add https://github.com/basecamp/omarchy --skill omarchy-basecamp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Omarchy configuration changes across Hyprland, Waybar, Walker, and terminal apps are risky and error-prone; this Skill provides guardrails and a standardized workflow to prevent unintended edits.

Core Features & Use Cases

  • Enforces safe editing practices by isolating user config edits in ~/.config and documenting reset paths.
  • Provides centralized command discovery for omarchy-* operations and guidance on common tasks like theming, window rules, and display settings.
  • Supports automation hooks and reset mechanics to recover from misconfigurations, ensuring reproducible environments.

Quick Start

Provide your requested config change and I'll validate it against Omarchy's safety rules.

Frequently Asked Questions about omarchy

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

FAQPage Schema
How do I safely edit Hyprland and Waybar configs in Omarchy Linux?

To safely manage Omarchy configs, isolate user edits within ~/.config. This prevents risky changes to Hyprland and Waybar by providing reset commands and clear boundaries for safe modifications.

How can I reset Omarchy themes and display settings after a misconfiguration?

Reset Omarchy themes and display settings using built-in reset mechanics. The Skill exposes centralized command discovery for omarchy-* operations to help recover from misconfigurations and restore reproducible environments.

How do I find available omarchy commands for changing window rules and keybindings?

Find available omarchy commands through a centralized command discovery surface. It provides guidance on common tasks like theming, window rules, and display settings to ensure consistent config changes.

Can I automate Omarchy config management for consistent Hyprland environments?

Yes, you can automate Omarchy config management using supported automation hooks. This enforces safe editing practices and provides reset mechanics to ensure reproducible Hyprland and terminal environments.

Why are manual edits to Omarchy terminal configs considered risky?

Manual edits to Omarchy terminal configs are risky because they lack standardized guardrails. Applying changes directly without isolating edits in ~/.config can lead to unintended misconfigurations across the system.