Skip to content
pavstevPublic

About

AI-ready dotfiles for macOS, Linux and Windows. One command sets up Claude Code, Cursor and Opencode with shared skills, agents, rules and guard hooks, plus a fast zsh terminal.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

dotfiles logo: a prompt chevron, a dot and a blinking cursor on a night sky

dotfiles

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.

macOS Linux Windows Claude Code Cursor Opencode AGENTS.md MIT

Install · What you get · Every day · Docs · The story

New here? The story page shows how the skills, agents and guard fit together.

⚡ Install

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.

✨ What you get

🤖 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.

🧭 Every day

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.

📚 Docs

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.


MIT licensed · made by @pavstev

About

AI-ready dotfiles for macOS, Linux and Windows. One command sets up Claude Code, Cursor and Opencode with shared skills, agents, rules and guard hooks, plus a fast zsh terminal.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages