paseo-worktreeinclude
by cpreciosoPaseo plugin that copies gitignored files listed in .worktreeinclude into new git worktrees, like Claude Code does.
- Requires Paseo 0.10.3 or newer.
- The copy runs on workspace.created and does not block agent startup, so an agent that reads these files immediately may race the copy.
From the plugin's README
The copy runs on Paseo's workspace.created event, which does not block agent startup. An agent that reads these files immediately may race the copy. If that matters, use a worktree.setup step in paseo.json instead.
Install
npmjs · Paseo 0.9+
paseo plugin add npm:@cprecioso/paseo-worktreeinclude@0.1.1GitHub · Paseo 0.8 fallback
paseo plugin add cprecioso/paseo-worktreeinclude --ref d32b1a4d1eeced93c964073813be5289d6150171Git security status and fallback installation are pinned to commit d32b1a4d1eec.
From the plugin's README
Requires Paseo 0.10.3 or later.
paseo plugin install npm:@cprecioso/paseo-worktreeinclude
Or from GitHub:
paseo plugin install github:cprecioso/paseo-worktreeinclude
README
paseo-worktreeinclude
A Paseo plugin that copies gitignored files listed in .worktreeinclude into new git worktrees, the same way Claude Code does.
When a workspace is created in a linked git worktree, the plugin reads .worktreeinclude (gitignore syntax) from the main checkout and copies every file that matches it and is gitignored. Tracked files are never touched, and files already present in the worktree are not overwritten. Copies use copy-on-write cloning (APFS, btrfs) when available.
# .worktreeinclude
.env
.env.*
config/secrets.json
Install
Requires Paseo 0.10.3 or later.
paseo plugin install npm:@cprecioso/paseo-worktreeinclude
Or from GitHub:
paseo plugin install github:cprecioso/paseo-worktreeinclude
Caveat
The copy runs on Paseo's workspace.created event, which does not block agent startup. An agent that reads these files immediately may race the copy. If that matters, use a worktree.setup step in paseo.json instead.
Scanned 09 Oct 2026, 09:34 UTC from cprecioso/paseo-worktreeinclude.