Skip to main content

Troubleshooting

This setup wires a lot of automation into chezmoi apply. When something goes wrong, start by identifying whether you're dealing with:

  1. A template rendering problem
  2. A hook script failing
  3. A missing dependency (brew/mise/op/gh/etc.)

First Checks​

chezmoi diff
chezmoi apply

If chezmoi apply errors, the failing script path is usually the most useful signal.

1Password Readiness Gate​

home/.chezmoi.toml.tmpl exits early if you answer "no" to "Is 1Password ready". Make sure the 1Password app is installed, unlocked, and the SSH agent is available.

Relevant files:

Brew Bundle Cleanup Surprise​

The brew hook runs cleanup in addition to install:

If you had packages installed manually (outside the Brewfile), they can be removed. Treat the Brewfile as the source-of-truth.

GitHub CLI Auth Prompts​

The GitHub extensions hook will run gh auth login if you're not authenticated:

The manual packages installer also relies on gh release download:

Password Store Setup​

If you see missing API keys or tools failing to authenticate, check whether pass is set up and your password store repo is present.

See Also​