omarchy

Discover Quickshell, Omarchy's core Wayland compositor and desktop toolkit. Learn how this single process powers your entire UI with dynamic JavaScript/QML plugins.

Learn how Omarchy manages shell plugins. It discovers, validates, and activates extensions securely through a central PluginRegistry, ensuring only enabled plugins run.

Discover Omarchy's migration framework: an automated system that uses ordered, idempotent shell scripts to synchronize user configurations with new releases. Streamline your upgrades.

Discover how Omarchy manages themes with a template-driven system. Learn about shell commands, placeholder rendering, and protecting user overrides in Basecamp's Linux desktop.

Learn what omarchy-provision-first-run handles: initializing Omarchy, enabling services, deploying configs, running migrations, and more. Ensure a smooth setup.

Discover the idempotency marker for omarchy-provision-user, the finalize-user file, and learn how to prevent duplicate executions. Understand its implementation and `--force` flag.

Learn how Omarchy manages skill symlinks during user provisioning. Discover how centralized skills link to per-user directories for Claude, Codex, Pi, and Gemini.

Learn what omarchy finalize user does to complete per-user setup, including symlinks, app configuration, and script sourcing. Understand user provisioning in Oarchy.

Discover how the /etc/skel directory in Omarchy seeds new user accounts with essential dotfiles and XDG configurations, streamlining user setup and personalization.

Learn how Omarchy populates a new user's home directory by copying default config files with the omarchy-refresh-config utility during first login.

Master Omarchy command naming conventions for structured CLI development. Learn the prefix and verb-group structure to build consistent and intuitive commands.

Discover how Omarchy CLI command groups are defined using the GROUP_DESCRIPTIONS associative array in the bin/omarchy script. Learn about automatic command discovery.