Getting Started

The dotfiles are designed to bootstrap a fresh Omarchy machine and then keep it in sync with a single command. Start with the install guide, then use the checklist for a clean walkthrough.

Personal dotfiles

These are my own dotfiles, tuned for Omarchy and my machines, and they lean on a deeply integrated private overlay that is not public. Don’t install them wholesale on a machine you care about, and don’t expect them to work on plain Arch without replicating my setup. Read them, take the bits you want, and fold them into your own dotfiles instead. The steps below are how I set up a new machine, documented for reference.

Install Prerequisites, bootstrap build, and the ongoing workflow.

New Machine Checklist A numbered, end-to-end setup for a new machine.

How it fits together

• Public dotfiles live at ~/.config/dotfiles and are applied with GNU Stow.
• Optional private dotfiles at ~/.config/dotfiles-private overlay machine-specific config.
• The dot binary owns setup (dot init), ongoing sync (dot update), and day-to-day tooling.

Note

The dot binary is compiled from dot/ in the repo. On a fresh machine you build it once with system mise before it is on your PATH. See Install.