Dotfiles for Linux/macOS development.
dotfiles/: files linked into$HOMEwith a leading dot, such as~/.zshrc.config/nvim/: Neovim configuration linked into~/.config/nvim.config/herdr/: Herdr configuration files linked individually into~/.config/herdrso runtime state remains local.pi/: pi coding agent config (settings, keybindings, extensions, skills, prompts, themes) linked into~/.pi/agent/. Secrets and sessions stay outside the repo.scripts/: command-line helpers linked into~/.local/bin/.bootstrap.sh: runs platform setup, installs pi, configured pi packages, and Basic Memory skills globally, and creates symlinks..githooks/: Git hooks that runbootstrap.shafter eachgit pull.
Run ./bootstrap.sh once on each machine. It sets core.hooksPath to .githooks, so each later git pull that changes the branch runs bootstrap.sh again. The bootstrap skips install steps that are already done, then relinks the configuration and updates packages.
A pull runs the pulled version of bootstrap.sh. Review remote changes before you pull them.
Bootstrap installs the skills globally on Linux and macOS without interactive prompts:
npx --yes skills add basicmachines-co/basic-memory/skills --global --yesThis requires npx, provided by the npm dependency in both platform setups.
pi-commit sends the staged Git diff to a non-interactive, tool-free pi run and prints a Conventional Commits message. Dry-run mode is the default and caches the message under the repository's Git directory:
pi-commit # print/cache a message
pi-commit --apply # commit using that message