Installation
One command
Section titled “One command”curl -fsSL https://install.dotfiles.wiki/ | shOnly macOS is supported for this repository. The command works on Linux for other repositories; see your own repository.
What happens
Section titled “What happens”-
The Cloudflare Worker returns a shell script for the detected OS.
-
The script installs the Xcode Command Line Tools if
gitis missing, then installs chezmoi into~/.local/bin. -
chezmoi init --applyclones the repository and renders every file into~. -
The age key is decrypted. This is the only prompt: the passphrase for
key.txt.age. -
Homebrew is installed if missing, then
brew bundleinstalls everything in the Brewfile. This is the slow step. -
Homebrew bash becomes the login shell.
sudoasks for your password once to register it in/etc/shells.
After it finishes, open a new terminal or start an agent. mise installs its tools on first use of each shim.
After installation
Section titled “After installation”Create ~/.config/secrets.env with any API keys agents need, one export NAME=value per line, and chmod 600 it. The shell sources it on every start. It is never tracked.
Register ~/.ssh/id_ed25519.pub on GitHub as both an authentication and a signing key if the machine is new:
gh auth logingh ssh-key add ~/.ssh/id_ed25519.pub --type authentication --title "$(hostname -s)"gh ssh-key add ~/.ssh/id_ed25519.pub --type signing --title "$(hostname -s) signing"Your own repository
Section titled “Your own repository”The installer is generic. Query parameters pick the repository:
| Parameter | Default | Values |
|---|---|---|
username | kiliantyler | any account name |
provider | github | github, gitlab, bitbucket, or a bare domain |
repo | dotfiles | repository name |
branch | main | branch name |
os | user agent | macos, linux, or windows for a PowerShell script |
curl -fsSL 'https://install.dotfiles.wiki/?username=you&provider=gitlab&branch=dev' | shiex "&{$(irm 'https://install.dotfiles.wiki/?username=you&os=windows')}"The script runs chezmoi init --apply <repo-url> --branch <branch>, so the target repository has to be a chezmoi source directory.