Skip to main content

Refreshing Externals

This setup uses chezmoi externals for a few third-party assets (TPM, bat themes, Hammerspoon spoons, lowfi tracklists).

Externals are defined in:

Archive entries use codeload.github.com directly. GitHub's /archive/ URLs redirect to those same codeload URLs, so using the backend directly avoids intermittent failures before the redirect.

Preconditions

  • You changed external definitions or want to force a re-sync.

Steps

To force-refresh externals when applying:

chezmoi apply --refresh-externals=always

If you want to see what would happen without changing anything:

chezmoi apply --refresh-externals=always --dry-run --verbose

Verification

  • Confirm the expected external directories/files were refreshed.
  • Re-run:
chezmoi apply --refresh-externals=always --dry-run --verbose

and confirm no unexpected churn remains.

Rollback / Undo

chezmoi apply