wrktreez 0.1.0

Copy uncommitted local files into Claude Code worktrees automatically.

wrktreez

Copy uncommitted local files (.env, prompt files, API docs, sample JSONs, local config) into Claude Code worktrees automatically.

Why

Claude Code creates a fresh checkout for each worktree. Files you've intentionally never committed to Git (e.g. .env) don't get copied — you have to do it manually every time. wrktreez automates that.

Install

pip install wrktreez
# or
uv tool install wrktreez

Usage

cd your-project
wrktreez init              # creates wrktreez.yaml + installs the WorktreeCreate hook
wrktreez config show       # show effective config

Edit wrktreez.yaml:

copy:
  - .env
  - .env.example
  - prompts/**
  - docs/**
  # or:
  - all                    # copy every untracked + gitignored file (with safety skip-list)

When you run claude --worktree my-feature, the hook fires and copies your listed files into the new worktree.

Cleanup

wrktreez init registers two hooks in .claude/settings.json:

• WorktreeCreate — runs git worktree add and copies your files
• WorktreeRemove — runs git worktree remove and deletes the worktree-<name> branch

The WorktreeRemove hook fires when Claude Code explicitly removes a worktree (not on normal session exit — Claude Code keeps the worktree around so you can resume with claude --continue). To remove a stale worktree manually:

git worktree remove --force .claude/worktrees/my-feature
git branch -D worktree-my-feature

Manual sync

wrktreez sync .claude/worktrees/my-feature
# or, to preview:
wrktreez sync --dry-run --source . --dest /tmp/worktree

License

MIT