trpfrog's dotfiles for macOS and Linux.
First, clone this repository to your home directory.
cd ~
git clone https://github.com/trpfrog/dotfiles.gitThen copy config.example.yaml to ~/dotfiles/config.yaml and edit it for this machine.
This file is ignored by Git. See Machine-specific settings.
cp ~/dotfiles/config.example.yaml ~/dotfiles/config.yamlRun the install script.
~/dotfiles/install.shTo use a config stored somewhere else, pass its path.
~/dotfiles/install.sh path/to/config.yamlapt update
apt install -y git zsh
chsh -s $(which zsh)
~/dotfiles/install.shThis script runs bin/deploy.sh, then runs each item in install of the config (install/<item>.sh) in order.
Without a config, it only runs bin/deploy.sh.
If the config has a problem, it stops before doing anything.
This script creates symbolic links to the home directory, includes the shared .gitconfig,
and writes git.name / git.email of the config to ~/.gitconfig.
It also links each coding-agent skill in skills/<name> into ~/.claude/skills and ~/.codex/skills,
only for the agents whose directory exists. Other skills already in those directories are kept.
It only does things that are safe on any machine.
skills/ holds general-purpose agent skills, laid out as skills/<name>/SKILL.md
following the Agent Skills specification.
| Skill | What it does |
|---|---|
diagram-for-review |
Draws Mermaid diagrams for code review, written so each node reads on its own |
review-comments |
Checks code comments in a change: written for future readers, not reviewers, and not repeating the code |
prepare-push |
Runs the steps before pushing a branch in a fixed order, and keeps history intact once reviewers are assigned |
To use them without these dotfiles, install them with the GitHub CLI (preview) or the skills CLI:
gh skill install TrpFrog/dotfiles diagram-for-review --agent claude-code --scope user
npx skills add TrpFrog/dotfiles --skill diagram-for-review -gOn machines with these dotfiles, bin/deploy.sh links them instead, so edits apply immediately.
The shared configuration does not know which machine it runs on.
Settings for each machine are written in one file outside this repository:
$DOTFILES_CONFIG, or ~/dotfiles/config.yaml by default.
To keep it in another repository, set DOTFILES_CONFIG or symlink it to ~/dotfiles/config.yaml.
install: # install items, run in order (install/<item>.sh)
- homebrew
- sheldon
git:
name: your-name
email: "you@example.com"- The file is read by
lib/config.zshwith zsh builtins only, so it works on a fresh machine without extra tools. It accepts a subset of YAML: 2-space indents, up to 2 levels of nesting,- valuelists, and[]for an empty list. Anything else is an error. - Brewfile:
homebrew.brewfileselects the Brewfile for this machine.install.shrunsbrew bundlewith it, and it is rewritten after everybrew install/uninstall. The recommended value is~/dotfiles/config/Brewfile, but there is no default: nothing is installed unless you set it, so another machine's packages are never installed by accident. config.schema.jsongives completion and type checks in editors (for example, VS Code with the YAML extension).- See install for the available install items.
Commits from Claude Code and Codex shells are signed with an agent-only SSH key
kept in 1Password (set in .zshrc). The key-loading helper and the macOS login job are restored
by the agent-signing install item.
See setup instructions.
Only the 1Password reference is tracked; private keys
and GitHub tokens remain outside this repository.
This script applies macOS settings. It is run by bin/deploy.sh on macOS.
This repository includes docker-compose file for debugging.
docker compose up -d
docker compose exec dotfiles zsh