Skip to content

Omarchy & Hyprland

These dotfiles run on Omarchy. Some Omarchy components are tracked as managed git repos that dot keeps in sync, while Hyprland and Ghostty config are stowed dotfiles packages with per-host overrides.

  • waybar and uwsm are single-branch Omarchy repos expected on main.
  • bootstrap is expected on distro/omarchy.
  • dot update syncs these by default; dot doctor verifies their worktree branches.

Hyprland config is not a tracked Omarchy repo. It is a stowed dotfiles package (hypr/.config/hypr/, conf-only) laid down with --no-folding, with host-specific overrides selected by a runtime symlink. See Host Overrides.

Ghostty config is also stowed from ghostty/.config/ghostty/. The stowed launcher loads config.$OMARCHY_HOST when a host override exists.