Dotfiles

Personal dotfiles for macOS and devcontainers, managed with GNU Stow.

What's included

Package	Contents
zsh/	Shell config (zimfw framework)
starship/	Starship prompt config
git/	Git config and global ignores

Plus a Brewfile for macOS packages and an install.sh bootstrap script.

Setup

git clone https://github.com/ppejovic/dotfiles.git ~/dotfiles
cd ~/dotfiles
./install.sh

The install script is idempotent and safe to rerun.

On macOS it will:

1. Install Homebrew (if missing)
2. Install packages from the Brewfile (stow, starship, direnv, gh, etc.)
3. Back up any conflicting files to ~/.dotfiles_backup/
4. Symlink dotfiles into $HOME via Stow
5. Install zimfw and its modules
6. Install Claude Code

In devcontainers (Linux) it will:

1. Install stow, starship, and direnv via apt/curl
2. Back up any conflicting files to ~/.dotfiles_backup/
3. Symlink dotfiles into $HOME via Stow
4. Install zimfw and its modules
5. Install Claude Code

Devcontainers pick up this repo automatically via the VS Code dotfiles.repository setting.

Managing packages

stow <pkg>       # link a package
stow -D <pkg>    # unlink a package

Stow packages mirror the home directory structure, e.g. starship/.config/starship.toml links to ~/.config/starship.toml.