Cade's Dotfiles

My macOS and Linux development environment: shells, languages, editors, and agents. Package lists select the tools; configuration templates set them up.

Install Configure Use an agent Find a tool Update & fix

Package listspackages/*Homebrew, Cargo, npm, uv Install and checkbootstrap.shRuns the installers On your machineTools and runtimesHomebrew and local prefixes

Configuration sourcehome/*Shells, editors, agents Render and applychezmoi applyUses this machine's settings In your home directory~/.zshrc, ~/.config/Plus each agent's config

Bootstrap runs both paths. After setup, you can apply configuration changes separately.

Set up a machine

From an interactive terminal:

Install from a checkout

git clone https://github.com/cadebrown/dotfiles ~/dotfiles
~/dotfiles/bootstrap.sh

Expect name/email prompts, installer progress, then a tool check. Linux runs without sudo; initial macOS Homebrew setup may request administrator authentication.

• Choose a setup — Full is the default. Core narrows Python/Cargo tools; both use the same Homebrew list.
• Shared home? Configure PLAT isolation before installing.
• Installation steps · Sign in to services

Change a setting

Edit the zsh source, inspect the diff, then apply:

Edit → inspect → apply

"${EDITOR:-vi}" ~/dotfiles/home/dot_zshrc.tmpl
chezmoi diff ~/.zshrc
chezmoi apply ~/.zshrc
exec zsh -l

The new shell loads the result. Edit sources under home/ to retain changes across applies. Find other files in the configuration map or follow a configuration recipe.

Use an agent

With Codex installed and signed in:

Start a review session

cd ~/dotfiles
codex -p review

Example prompt

Trace how DF_USE_PLAT changes the Node executable path.
Show the source files and line references, then give me a command
to inspect the result in my current shell. Do not change files.

The review profile is read-only. Expect source locations and an inspection command to run on the target machine.

Choose an agent · Codex profiles · Instructions · Workflow examples

Find tools and guides

I need to…	Start here
Find a tool or connection	Packages · Skills · MCP servers
Understand how it fits together	Architecture · Paths
Configure my workspace	Shell & editors · Environment variables
Use local models or resume work	Local AI · Durable tasks
Add a feature	Write the guide · Show it working

Update or troubleshoot

Command	Effect
~/dotfiles/bootstrap.sh update	Pull repository changes and install missing tools
~/dotfiles/bootstrap.sh upgrade	Update the repository and request package upgrades
bash ~/dotfiles/install/verify-path.sh	Check executable locations and PATH ordering
bash ~/dotfiles/install/codex.sh check	Check the managed Codex setup

Search an error message or open Troubleshooting. See Daily maintenance for package and configuration updates.