omarchy

chezmoi source for an Omarchy machine (Arch + Hyprland), hosted at https://prad.codes/env/omarchy.

Install Omarchy first, then on that machine:

sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply https://prad.codes/env/omarchy.git
# or over SSH:
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply git@prad.codes:env/omarchy.git

chezmoi clones the dot_config/fish and dot_config/hypr submodules during init.

First apply prompts once for name, email, and machine role (desktop | laptop | server, default desktop). desktop and laptop get the Omarchy layer (Hyprland config, Waybar, uwsm env, fontconfig, mimeapps, systemd user units, omarchy-* scripts); server gets the universal toolset only.

Prerequisites

• Omarchy installed (provides Hyprland, Waybar, the omarchy-* commands and yay). sudo for pacman; if no yay/paru exists the install script bootstraps yay.

• Secrets: age-encrypted files need the key at ~/.config/chezmoi/key.txt. Copy it there before chezmoi apply (distributed manually, never committed):

  mkdir -p ~/.config/chezmoi
  scp <existing-machine>:.config/chezmoi/key.txt ~/.config/chezmoi/key.txt
  chmod 600 ~/.config/chezmoi/key.txt
  

What's managed

Universal: fish, bash + zsh (starship prompt, shared aliases), nvim, tmux, kitty, ghostty, yazi, lazygit, lazydocker, gh (+ extensions), topgrade, git, ssh config, Claude Code and agent skills. Packages are declared in .chezmoidata/packages.yaml and installed by .chezmoiscripts (idempotent, re-run when the manifest changes).

Aliases are defined once in .chezmoidata/aliases.yaml and rendered into fish (fish/conf.d/20-aliases.fish) and bash/zsh (~/.config/shell/aliases.sh, sourced by .bashrc/.zshrc).

Shell utilities live as standalone sh/bash executables in ~/.local/bin so all shells share one implementation; helpers that must mutate shell state (cd-style) are per-shell functions in fish/functions/, bash/functions/, and zsh/functions/.

Agent skills are not vendored: .chezmoidata/skills.yaml lists every skill and its upstream source, and .chezmoiscripts/run_onchange_after_25-skills.sh.tmpl installs them with the Skills CLI whenever that file changes.

Omarchy layer (roles desktop/laptop): dot_config/hypr (submodule), dot_config/waybar, dot_config/uwsm, fontconfig, mimeapps, xdg-terminals.list, systemd user units, and the omarchy-* scripts in dot_local/bin.

Submodules and externals

• Submodules: dot_config/fish (prdlk/fish), dot_config/hypr (prdlk/hypr).
• Externals (.chezmoiexternals/): kitty, ghostty, tmux, tmux-palette, television, yazi, herdr, omp, omarchy (~/.config/omarchy), agent-root, plus nvim, tpm and a bat syntax in .chezmoiexternal.toml.

gh needs gh auth login once per machine; the extension install script skips gracefully until then and re-runs on the next apply.

Docs

See docs/README.md. Agent rules for working in this repo: AGENTS.md.