dotfiles

This repo contains the configuration to set up configuration and install programs. Uses chezmoi for dotfile management and Ansible for package installation.

todo: vimium — automate backup/restore of settings (keybindings + custom CSS) via chezmoi

Fresh machine setup

No git, brew, or chezmoi required — just run this one command:

sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply trentshaines

This will:

1. Download chezmoi
2. Clone this repo to ~/.local/share/chezmoi/
3. Apply dotfiles
4. Run the Ansible playbook to install brew, packages, and casks

You will be prompted for your password twice: once upfront to pre-warm sudo (so brew cask installers like Docker and Tailscale can run without a TTY), and once by Ansible itself for tasks that require privilege escalation (adding fish to /etc/shells, setting default shell).

Manual steps after setup

These apps are installed automatically but require permission grants on first launch:

Karabiner-Elements — keyboard remapping

Open Karabiner-Elements and approve the System Extension and Input Monitoring prompts in System Settings. The config is managed via chezmoi at ~/.config/karabiner/.

AeroSpace — tiling window manager

Open AeroSpace and grant Accessibility access. Enable it in System Settings → General → Login Items so it starts on boot.

Espanso — text expander

Grant Accessibility access when prompted, then register it as a service:

espanso service start

Obsidian — note-taking

Enable the CLI in Settings → General → Advanced → Command line interface.