worktree-setup

Solid

Set up worktree-plus for a repo — manage git config (baseBranch, branchPrefix, dirBase, guessRemote) and build the .worktreeinclude / .worktreelink files by scanning which gitignored files actually exist. Use when the user asks to set up or configure worktree-plus, view or change worktree settings, reset the plugin config, or decide which gitignored files should be copied or symlinked into new worktrees.

AI & Automation 51 stars 4 forks Updated today MIT

Install

View on GitHub

Quality Score: 87/100

Stars 20%
57
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# worktree-plus Setup Two jobs live here, and a user usually wants one of them: - **Settings** — git config under the `worktreeplus.*` namespace (plugin-custom) plus one `worktree.guessRemote` (git-native). No env vars. Start at [Settings](#settings). - **Which gitignored files follow a worktree** — the `.worktreeinclude` (copy) and `.worktreelink` (symlink) files at the repo root. Start at [Set up .worktreeinclude / .worktreelink](#set-up-worktreeinclude--worktreelink). If the user's ask is vague ("set up worktree-plus"), show the current settings first — it's cheap and orients both of you — then offer the include/link scan. ## Settings | Key | Default | Scope guidance | |---|---|---| | `worktreeplus.baseBranch` | `HEAD` | Per-repo typical (different repos have different default branches) | | `worktreeplus.branchPrefix` | `worktree-` | Global typical (personal naming convention); per-repo for team rules | | `worktreeplus.dirBase` | `.claude/worktrees` | Per-repo typical | | `worktree.guessRemote` | `true` (plugin override; git default is `false`) | Global typical | ## View current settings Always start by showing what's active. Run: ```bash git config --get-regexp '^worktreeplus\.|^worktree\.guessRemote' ``` If nothing prints, the user is on defaults. State that explicitly — don't leave them guessing. For layered view (local vs global vs system): ```bash git config --local --get-regexp worktreeplus git config --global --get-regexp worktreeplus ``` ## Change a se...

Details

Author
LeeJuOh
Repository
LeeJuOh/claude-code-zero
Created
7 months ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Listed

worktree-setup

Use when starting an isolated task that needs a git worktree on a NEW branch — any project. Triggers — "set up a worktree for X", "start a worktree for this task", "isolate this work in a worktree", or before a subagent-driven / executing-plans run on a repo not already in a linked worktree. Reads a per-project config (in-repo .worktree.json or a registry under $CLAUDE_PLUGIN_DATA/projects) to decide single vs dual/multi-repo scope (identical branch names on coupled repos), cut from the right base branch, copy env files, and run the right install command. No-op when no config matches and you are not asked to init one.

1 Updated 1 weeks ago
punkaze
Data & Documents Listed

worktree-setup

Provision a freshly-created git worktree so it's actually ready to work in — trust its mise.toml, copy gitignored-but-needed files (Rails config/master.key, .env, …) from the main checkout, and re-mark shebang scripts executable. Use right after creating a worktree (native EnterWorktree or `git worktree add`), or when a new worktree errors with "mise.toml not trusted", is missing secrets/.env, can't load the app, or has non-executable scripts. Also when parallel worktrees collide on the same dev-server port or database — opt into per-worktree ports + databases via a `.worktree-isolate.conf`. Pairs with using-git-worktrees (which creates the worktree; this provisions it).

0 Updated yesterday
mickzijdel
Code & Development Listed

worktree-new

Git worktree conventions for isolated parallel feature work. Use when starting a new coding task, feature, bugfix, or PR-review in a git repository — anytime work should get its own branch and worktree instead of touching the main checkout, or when the user asks to work in / create / list / remove a worktree. Applies to whatever repository Claude is currently in.

0 Updated 1 months ago
Enverge-Labs