dotfiles

A reproducible macOS development environment powered by mise and Homebrew.

Quick Start

Clone the repository and create the stable ~/.dotfiles root.

mkdir -p ~/ghq/github.com/tdkn
git clone https://github.com/tdkn/dotfiles.git ~/ghq/github.com/tdkn/dotfiles
cd ~/ghq/github.com/tdkn/dotfiles
ln -sfn ~/ghq/github.com/tdkn/dotfiles ~/.dotfiles

Install the latest mise with Homebrew.

brew install mise
brew upgrade mise

Trust, review, and apply the bootstrap.

mise trust --all
mise bootstrap --dry-run --force-dotfiles
mise bootstrap --yes --force-dotfiles

Usage

Use mise to inspect or refresh the environment.

mise bootstrap --dry-run --force-dotfiles
mise bootstrap --yes --force-dotfiles
mise dotfiles status --missing
mise bootstrap macos-defaults status --missing
mise bootstrap user status --missing
mise brew-sync
brew bundle check --no-upgrade --file ~/.config/homebrew/Brewfile
mise doctor

Run mise brew-sync after changing Homebrew formulae, casks, or Mac App Store apps, then review the Brewfile diff before committing.

Agent Skills

Skills come from two places. Locally authored skills live in agents/skills/ and mise symlinks them into the agent skill directories, so editing one takes effect immediately and shows up as an unstaged change here. Third-party skills are declared in apm/apm.yml and installed by apm into the same directories.

mise run agents-sync

Add a local skill by creating agents/skills/<name>/SKILL.md, then adding one line per target agent to .config/mise/conf.d/40-dotfiles.toml and rerunning the bootstrap. A skill is only visible to the agents it is linked into.

"~/.agents/skills/<name>" = "~/.dotfiles/agents/skills/<name>"
"~/.claude/skills/<name>" = "~/.dotfiles/agents/skills/<name>"

Add a third-party skill by editing apm/apm.yml, running mise run agents-sync, then committing the apm/apm.lock.yaml diff.

The GitButler skill ships with the but binary rather than through apm, so it is installed separately. mise run agents-sync reports version drift after a brew upgrade; resolve it with but skill install --global.

apm covers the user-scope skills described here. The skills CLI stays installed for project-scoped skills in individual repositories.

Git Signing

Git commit and tag signing use 1Password's SSH signing program. Create an Ed25519 SSH key in 1Password, enable the SSH Agent, and add the public key to GitHub as a signing key.

Keep the signing key in a local include file:

[user]
	signingkey = ssh-ed25519 ...

Save it as ~/.config/git/1password-signing.config, then rerun the bootstrap. The GitHub verified email must match the configured Git commit email.

License

MIT