outfit

One repo. Many outfits. Hot swap your agent harness and your local checks, without messing up git.

outfit swaps files in a git repository (AGENTS.md, CLAUDE.md, a skills folder, hook checks) for your own versions. Only on your machine. git status stays clean and nobody else's diff changes.

Same prompt, different outfit:

$ outfit use strict                   $ outfit use yolo
$ claude -p "add a login form"        $ claude -p "add a login form"

agent reads: "Plan first. Tests       agent reads: "Be terse. Just ship."
first. Formatter. Small diffs.
Linter clean. Always."

result: plan, tests, formatter,       result: 1 file
change, tests again, linter error,    took 20s
fix, tests again, lint again,
6 files, 14 tests
took 14m 32s

(An illustration. An outfit is a folder: your AGENTS.md, CLAUDE.md, skills and hook switches.)

curl -fsSL https://raw.githubusercontent.com/prosperity-solutions/outfit/main/install.sh | sh

One line. No login, no token, no sudo. macOS and Linux, git 2.36+.

How the trick works

1. A link stands where the file was, pointing into your profile.
2. Sparse checkout tells git to look away from that path. The committed file never changes, so there is no diff.
3. Hooks re-check after every pull, checkout and rebase. Git can't stage the link, and a commit guard backs that up by refusing a commit that has it.

Edit through the link and you edit your profile. An editor's atomic save is caught and copied back. Your bytes are never overwritten: if both sides changed, outfit saves both and asks. It works with any git repository and any hook setup (husky, lefthook, plain .git/hooks), and your team does not need to use it.

Try it in 60 seconds

cd your-repo
outfit init                          # put outfit in front of your git hooks (they keep running; `outfit use` does it for you)
outfit set hook.pre-commit=off       # skip the slow pre-commit hook, only for you
outfit ls                            # the profiles your team committed in .outfit/profiles (or: outfit new mine)
outfit use <profile>                 # swap in its files (your AGENTS.md instead of the team's)
git status                           # clean: nothing to commit, nothing for teammates to see
outfit uninstall                     # put everything back as it was

No repository of your own handy? scripts/demo.sh in a clone of this one (gh repo clone prosperity-solutions/outfit) builds a throwaway repository with a husky hook and walks through all of it in about half a minute, printing each step before it runs and checking what it claims: init, switching a hook off, a shared profile, editing through the link, an editor's atomic save, a new worktree, your own profile and promote, showing hidden profiles, the line for teammates without outfit, and uninstall.

What it is for

• A heavy hook on a small laptop. One pre-commit check eats 5 GB of RAM. Turn that hook off here, nowhere else: outfit init, then outfit set hook.pre-commit=off --global.
• Trying your own agent instructions. Edit your AGENTS.md without a diff in everyone's way, and when it is good, share it as a profile colleagues can opt into.
• Your own skills directory. A profile can replace a whole directory (replace = .claude/skills in its profile.config): the team's files below it are hidden for you and yours stand in, files the repository does not have included (docs/profiles.md).
• A permanent personal setup. A yolo profile that skips most local checks. Local hooks are a convenience and CI is the real gate, so that is a fair choice. (A hook the team marks locked, such as locked = hook.pre-push, cannot be skipped.)

Install, in detail

It is a single static binary for Linux (amd64, arm64) and macOS (universal), needs git 2.36 or newer, and never uses sudo: it puts outfit in ~/.local/bin (or next to the one you already have; on a Mac that folder is not on your PATH yet, and the installer prints the line to add to ~/.zshrc). It checks a SHA-256 (which catches a broken download) and the release signature (which catches a tampered release); the signature check needs nothing installed first. Options, and checking a download by hand: docs/install.md. Later, outfit update installs the newest release itself (after checking its signature); see docs/update.md. To see it work first, scripts/demo.sh in a clone of this repository (gh repo clone prosperity-solutions/outfit) walks through it all in a throwaway repo.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗