Skip to content

Configuration ​

Customize the bootstrap behavior with environment variables, skip flags, and local Git overrides.

Environment Variables ​

VariableEffect
ONLY_STOW=1Skip all installers — only symlink configs
SKIP_<STEP>=1Skip a specific step (see full list below)
APPLY_MACOS_DEFAULTS=1Opt-in to macOS system preferences automation
EXTRA_TOOLS="pkg1 pkg2"Additional apt or pacman packages to install alongside defaults
EXTRA_CONFLICT_FILES="path1"Extra files to back up before stowing
BREWFILE_PATH=/pathOverride the macOS Brewfile location
BREW_CLEANUP=1Remove unlisted Homebrew packages after install
UPGRADE_PACKAGES=1Also upgrade already-installed apt, Homebrew, and winget packages (pinned tools always upgrade to their pin)
GIT_FROM_PPA=1Ubuntu only: install Git from the git-core PPA instead of the distro package
DOTFILES_PROFILE=default|omarchyForce the full profile or the Omarchy profile (auto-detected by default)
OMARCHY_BLESH=1Omarchy: install ble.sh 0.4 (blesh-git) from the AUR for bash autosuggestions and syntax highlighting
OMARCHY_DEV_ENVS="go bun"Omarchy: runtimes installed with omarchy install dev-env ("" for none)

Stow-only mode

Run ONLY_STOW=1 ./bootstrap.sh to re-link configs without re-running any installers. Useful after editing a dotfile.

SKIP Flags ​

Use SKIP_<STEP>=1 to disable individual bootstrap steps.

Linux / macOS ​

FlagSkips
SKIP_MACOSmacOS Homebrew bundle
SKIP_PACKAGESBase apt or pacman packages
SKIP_GIT_PPAOpt-in git-core PPA step
SKIP_GHGitHub CLI from the official apt repository
SKIP_SSHSSH server setup
SKIP_OHMYZSHOh My Zsh + plugins + Powerlevel10k
SKIP_FONTSMesloLGS Nerd Font installation
SKIP_MISEmise with the pinned Node.js and Go runtimes and global npm CLIs
SKIP_BUNBun runtime
SKIP_RELEASE_TOOLSAll pinned release tools (just, lazygit, fzf, zoxide, delta, bat, fd, hyperfine, glow, fastfetch, atuin, yazi, superfile)
SKIP_<TOOL>One release tool, e.g. SKIP_LAZYGIT or SKIP_FZF
SKIP_TMUXPinned tmux source build
SKIP_NEOVIMNeovim AppImage
SKIP_EZAeza (modern ls)
SKIP_UVuv (Python package manager)
SKIP_AZURE_CLIAzure CLI
SKIP_AI_TOOLSHerdr, Codex, Claude Code, GitHub Copilot CLI, and Pi
SKIP_RUSTRust toolchain via rustup
SKIP_WSLWSL-specific setup
SKIP_MACOS_DEFAULTSmacOS system preferences (also requires APPLY_MACOS_DEFAULTS=1 to run)
SKIP_STOWSymlink step
SKIP_GIT_CONFIGAll local Git configuration below
SKIP_GIT_SIGNING1Password SSH commit signing
SKIP_GIT_CREDENTIALSGitHub credential helper
SKIP_SHELLDefault shell change
SKIP_OMARCHYOmarchy profile: extra packages, dev envs, npm globals, ble.sh
SKIP_OMARCHY_CONFIGOmarchy profile: hooking personal.sh and dotfiles.gitconfig into Omarchy's files

Windows ​

FlagSkips
SKIP_PACKAGESwinget package installs
SKIP_GIT_TOOLSGit-related tool setup
SKIP_NVMnvm-windows
SKIP_AI_TOOLSHerdr, Codex, Claude Code, and GitHub Copilot CLI
SKIP_RUSTRust toolchain
SKIP_FONTSFont installation
SKIP_EXTRASExtra tools
SKIP_PROFILEPowerShell profile linking
SKIP_LINK (or SKIP_STOW)Dotfile symlinks/junctions

WARNING

Skipping STOW / LINK means your config files won't be updated. Only skip this if you manage symlinks manually.

Global npm CLIs ​

Global npm packages are installed as mise npm tools, each in its own directory, so they survive Node.js version changes and are reinstalled automatically on every machine. Do not use npm install -g.

  • AI coding CLIs (Codex, Claude Code, Copilot, Pi) are declared in install/ai-tools.sh.
  • Everything else goes in install/npm-globals.txt, one package per line. Append allow-builds when a package needs its own install scripts, which mise skips by default.
  • Migrating from nvm: run scripts/import-npm-globals.sh once per machine to copy the existing global packages into the list, review it, and commit.

Git Identity ​

Identity, signing key, and delta settings live in one file shared by every profile, ~/.config/git/dotfiles.gitconfig; the default profile's ~/.gitconfig includes it and adds its editor, ignore file, and aliases. The shared file includes ~/.gitconfig.local for machine-specific overrides (this file is not tracked by git).

ini
# ~/.gitconfig.local — add your own overrides here
[user]
    name = Your Name
    email = you@example.com

Automatic Git Configuration ​

Bootstrap auto-configures the following when the relevant tools are detected:

FeatureConditionDisable with
1Password SSH signingop-ssh-sign binary detectedSKIP_GIT_SIGNING=1
GitHub credential helpergh CLI detectedSKIP_GIT_CREDENTIALS=1
  • 1Password SSH signing — enables gpg.format=ssh for commit signing via 1Password's SSH agent
  • GitHub credential helper — sets gh auth as the HTTPS credential helper for seamless git push/pull

Adding New Config Modules ​

To add a new tool's configuration to the dotfiles:

  1. Create a directory that mirrors the home directory structure:
bash
mkdir -p alacritty/.config/alacritty
cp ~/.config/alacritty/alacritty.toml alacritty/.config/alacritty/alacritty.toml
  1. Add the directory name to STOW_DIRS in bootstrap.sh

  2. Restow to activate:

bash
stow -v -R -t "$HOME" -d "$(pwd)" alacritty

TIP

GNU Stow maps the directory structure inside each package to your home directory. A file at alacritty/.config/alacritty/alacritty.toml becomes a symlink at ~/.config/alacritty/alacritty.toml.

Released under the MIT License.