chezmoiidempotent

Bootstrap Scripts

Copy-and-paste commands to bootstrap a fresh macOS, Linux, or Windows machine. Managed with chezmoi, designed for fast and repeatable setup.

hongymagic/dotfilesmacOS / Linux / Windows

Screenshot

macOS desktop with Aerospace tiling, simple-bar, Ghostty terminal, and Catppuccin Mocha theme.

macOS desktop with Aerospace tiling window manager, simple-bar status bar, Ghostty terminal with tmux, and Catppuccin Mocha theme

Quick Setup

Run the one-liner to clone the repo and bootstrap everything: Homebrew, chezmoi, dotfiles, packages, and diagnostics.

one-linersh

Or clone manually and run the bootstrap script directly:

manualsh

git clone https://github.com/hongymagic/dotfiles.git ~/Code/dotfilescd ~/Code/dotfiles./bootstrap.sh
# Optional: Configure macOS settings./scripts/macos.sh

git clone https://github.com/hongymagic/dotfiles.git ~/Code/dotfilescd ~/Code/dotfiles./bootstrap.sh
# Optional: Configure macOS settings./scripts/macos.sh

chezmoi Source Directory

This repository uses a non-standard chezmoi source directory for a smoother editing workflow.

Custom Source Directory

Instead of the default ~/.local/share/chezmoi/, dotfiles are managed directly from the git working tree. This allows editing files in the repo and applying them directly without syncing between two locations.

How it workssh

# bootstrap.sh sets sourceDir in ~/.config/chezmoi/chezmoi.tomlsourceDir = "~/Code/dotfiles/home"
# After bootstrap, these work from anywhere:chezmoi apply -v    # Apply changes from repochezmoi diff        # See pending changes  chezmoi cd          # Jump to source directory

# bootstrap.sh sets sourceDir in ~/.config/chezmoi/chezmoi.tomlsourceDir = "~/Code/dotfiles/home"
# After bootstrap, these work from anywhere:chezmoi apply -v    # Apply changes from repochezmoi diff        # See pending changes  chezmoi cd          # Jump to source directory

What bootstrap.sh Does

The bootstrap script is idempotent and handles the entire setup process automatically.

Installs Homebrew (macOS only)

Installs chezmoi

Applies dotfiles configuration

Installs Homebrew packages from Brewfile

Installs Bun global packages from bunfile

Fetches external dependencies

Provides comprehensive diagnostics

Manual Control

For granular control, run individual components separately.

# Install/update Homebrew packages only./brew.sh
# Apply dotfiles onlychezmoi apply -Rv
# Configure macOS system settings./macos.sh

# Install/update Homebrew packages only./brew.sh
# Apply dotfiles onlychezmoi apply -Rv
# Configure macOS system settings./macos.sh

Secrets via 1Password

Secrets are stored in 1Password and pulled automatically during chezmoi apply.

# Ensure 1Password CLI is installedbrew install 1password-cli
# Apply dotfiles (will prompt for 1Password sign-in)chezmoi apply -Rv

# Ensure 1Password CLI is installedbrew install 1password-cli
# Apply dotfiles (will prompt for 1Password sign-in)chezmoi apply -Rv

Manual Secrets (Without 1Password)

Create ~/.extra.zsh manually if you don't use 1Password.

~/.extra.zshsh

cat >> ~/.extra.zsh <<'EOF'# Git credentialsGIT_AUTHOR_NAME="Your Name"GIT_AUTHOR_EMAIL="your.email@example.com"
GIT_COMMITTER_NAME="$GIT_AUTHOR_NAME"git config --global user.name "$GIT_AUTHOR_NAME"GIT_COMMITTER_EMAIL="$GIT_AUTHOR_EMAIL"git config --global user.email "$GIT_AUTHOR_EMAIL"
# Add any API keys or other secrets hereexport OPENAI_API_KEY=EOF
chmod 600 ~/.extra.zsh

cat >> ~/.extra.zsh <<'EOF'# Git credentialsGIT_AUTHOR_NAME="Your Name"GIT_AUTHOR_EMAIL="your.email@example.com"
GIT_COMMITTER_NAME="$GIT_AUTHOR_NAME"git config --global user.name "$GIT_AUTHOR_NAME"GIT_COMMITTER_EMAIL="$GIT_AUTHOR_EMAIL"git config --global user.email "$GIT_AUTHOR_EMAIL"
# Add any API keys or other secrets hereexport OPENAI_API_KEY=EOF
chmod 600 ~/.extra.zsh

Custom PATH

Add custom directories to your PATH via ~/.path.zsh.

~/.path.zshsh

Aerospace (Optional)

Disable the Aerospace tiling window manager if you don't want it.

# Uninstallbrew uninstall aerospace
# Or disable via configchezmoi edit --apply ${XDG_CONFIG_HOME}/aerospace/aerospace.toml# Set start-at-login to false, then:chezmoi apply -Rv

# Uninstallbrew uninstall aerospace
# Or disable via configchezmoi edit --apply ${XDG_CONFIG_HOME}/aerospace/aerospace.toml# Set start-at-login to false, then:chezmoi apply -Rv

simple-bar

A customisable macOS status bar widget for Übersicht, themed with Catppuccin Mocha.

The default setup enables pill-styled Spotify, Music, sound, battery, date, and time widgets (in that visual order). The battery widget's caffeinate toggle is disabled — use a dedicated app like Lungo instead.

# simple-bar is installed automatically via chezmoi externals.# To refresh after config changes:cp ~/Code/dotfiles/home/dot_simplebarrc ~/.simplebarrcosascript -e 'tell application id "tracesOf.Uebersicht" to refresh widget id "simple-bar-index-jsx"'

# simple-bar is installed automatically via chezmoi externals.# To refresh after config changes:cp ~/Code/dotfiles/home/dot_simplebarrc ~/.simplebarrcosascript -e 'tell application id "tracesOf.Uebersicht" to refresh widget id "simple-bar-index-jsx"'

Included Features

Opinionated tooling and configuration included in this dotfiles repository.

XDGXDG Base Directory specification

HomebrewPackage management for macOS

BunJavaScript runtime and global packages

GhosttyTerminal emulator

tmuxTerminal multiplexer configuration

zshShell configuration

chezmoiDotfiles manager

CatppuccinUnified Mocha theme across tools

AerospaceTiling window manager (optional)

simple-barCustom macOS status bar (Übersicht)

HyprlandWayland compositor (Linux/Omarchy)

1PasswordSecret management via chezmoi templates

AI ToolsClaude, OpenCode, Codex, Continue, Gemini configs