AI-ready dotfiles for macOS, Linux and Windows.
One command sets up a fast terminal and installs the ps plugin for Claude Code, Cursor and Opencode: shared skills, agents, rules and guard hooks.
Install · What you get · Every day · Docs · The story
New here? The story page shows how the skills, agents and guard fit together.
Paste one line in a terminal. Do not use a Claude Code window for it.
macOS (Terminal app)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/pavstev/dotfiles/main/bootstrap.sh)"Linux (Debian, Ubuntu, Fedora, Arch, Alpine) and Windows (Git Bash)
bash -c "$(curl -fsSL https://raw.githubusercontent.com/pavstev/dotfiles/main/bootstrap.sh)"A few questions come first: your git name and email, the settings, and the optional looks.
Then it installs; the last line is dotfiles: done in <time>. Step by step, with what each OS
needs: docs/install.md. Stuck? Troubleshooting.
| 🤖 One plugin, three agents | Claude Code, Cursor and Opencode get the same rules, 20 /ps: skills and 8 agents from the ps plugin, which dots installs. |
| 🛡️ Guard hooks | A Rust guard checks each tool call: risky git, secrets in files, private words, runaway helpers. |
| 🧩 Presets | Opt-in working habits: workflow, models, clock, plain writing and more. |
| 🦀 One command | dots pulls, links and installs. It is idempotent, short, and dots doctor checks the result. |
| 🧰 40+ CLI tools | rg, fd, eza, bat, zoxide, fzf, atuin, delta, lazygit and more, from one tools.list via mise. |
| 🎨 Optional looks | Starship prompt, VS Code and Cursor settings, Nerd Font. Off until you pick them. |
| 🔒 Private by design | Settings and personal rules stay on the machine. Git hooks block secrets and private words. |
| ✅ Tested everywhere | /os-check runs the setup on macOS, five Linux distros and a Windows VM. |
| Command | What it does |
|---|---|
dots |
Get the newest setup: pull, link, install what is missing. |
dots settings |
Change a setting: git identity, presets, looks, Java, private rules. |
dots doctor |
Check the setup. One PASS or FAIL line per check, with the fix. |
More (dots update, dots -v, dots uninstall): Features.
In Claude Code, Opencode or Cursor, type /ps: to see the skills.
Edit files in ~/dotfiles/home/: they are linked, so a change is live at once.
Start with Install. Everything else is in the docs index: features, AI agents, platforms, customize and uninstall, troubleshooting, and the runbook Claude follows to set up a new machine. How AI agents work on this repo: AGENTS.md.
Fork it: change DOTFILES_REPO at the top of bootstrap.sh and the URLs above.