Skip to content
WillJRoperPublic

About

My configuration files for bash, prompt styles, aliases, etc.

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

51 Commits

Folders and files

Repository files navigation

Dotfiles

Personal macOS-first shell, terminal, editor, and developer-tool configuration managed with Chezmoi. Linux and HPC hosts receive a smaller compatible subset.

New Mac Setup

Start here. These guides assume a clean macOS installation without an iCloud backup. Keep the current Mac available until final verification passes.

1. Prepare The Old Mac

Complete setup/01_prepare_current_mac.md on the old Mac. This backs up secrets, stores the age identity, and confirms the repository and personal data are available remotely.

2. Bootstrap The New Mac

On the new Mac, complete setup/02_bootstrap_macos.md, then run the Clone Without Applying section of setup/03_install_dotfiles.md. Do not use chezmoi init --apply.

3. Choose A Setup Path

For agent-guided setup, install and launch OpenCode from the cloned repository:

brew install anomalyco/tap/opencode
opencode "$HOME/.local/share/chezmoi"

Complete provider authentication, then send:

Read setup/AGENT_SETUP_PROMPT.md and follow it exactly.

Keep this session interactive; do not use --auto. The agent prompt pauses clearly for secrets, passphrases, authentication, system permissions, external portals, and approval before applying changes.

For manual setup, continue from Install Core Software in phase 3, then follow the remaining guides in order:

  1. setup/03_install_dotfiles.md
  2. setup/04_restore_secrets_and_auth.md
  3. setup/05_restore_apps_and_data.md
  4. setup/06_verify_setup.md

Do not skip preview, secret rotation, or final verification steps.

Managed Configuration

  • Bash aliases, functions, prompt, completion, history, and vi-style editing
  • Minimal zsh fallback configuration
  • Git, Git LFS, Delta, GitHub CLI defaults, and global ignore rules
  • Neovim configuration and pinned plugin lockfile
  • tmux, TPM, session persistence, and sesh integration
  • Starship, WezTerm, Atuin, btop, neofetch, Television, and The Fuck
  • Arc, Raycast, Slack, Tailscale, Obsidian, Teams, WhatsApp, Zoom, VLC, Thunderbird, and Steam
  • Reproducible Dock ordering, small spacer groups, stack, and visual settings
  • OpenCode agents, MCP servers, Cloudflare skills, Caveman, and Ponytail
  • VS Code settings, keybindings, and reviewed extensions
  • Safe Vorssaint preferences
  • Encrypted SSH config; private SSH keys remain machine-local
  • Encrypted iCloud transfer helper for machine-local secrets
  • Python environment helpers and utility scripts

Machine-local credentials live in ~/.config/dotfiles/secrets.sh. This file is never managed by Chezmoi or Git.

Repository Layout

  • home/: Chezmoi source state mapped into the home directory
  • Brewfile: core software required by managed configuration
  • Brewfile.optional: opt-in scientific, compiler, and specialist software
  • setup/: ordered new-Mac setup instructions
  • docs/: audit records, migration notes, and application inventory

Updating An Existing Machine

Fetch and preview before applying:

chezmoi git pull -- --ff-only
chezmoi status
chezmoi diff
chezmoi apply --dry-run --verbose
chezmoi apply

Use chezmoi edit <target> to change managed files, or edit the directory returned by chezmoi source-path. Never force-apply over unexplained local changes.

Linux And HPC

Install Chezmoi with the platform package manager or official installer, then preview before applying:

sh -c "$(curl -fsLS get.chezmoi.io)"
chezmoi init https://github.com/WillJRoper/dotfiles.git
chezmoi diff
chezmoi apply

Homebrew manifests and macOS application scripts are macOS-specific.

Reference

About

My configuration files for bash, prompt styles, aliases, etc.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages