Skip to content

Commit 5e3db00

Browse files
author
zenus
committed
feat: add branch-specific humanize plugin worktree launcher
1 parent 71cdec7 commit 5e3db00

5 files changed

Lines changed: 677 additions & 10 deletions

File tree

docs/install-for-claude.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,37 @@ If you have the plugin cloned locally:
2626
claude --plugin-dir /path/to/humanize
2727
```
2828

29+
### Recommended Branch Workflow
30+
31+
If you actively switch between `main` and feature branches, do not keep reinstalling the plugin.
32+
Use branch-specific git worktrees and launch Claude with the matching plugin directory instead:
33+
34+
```bash
35+
# Ensure a dedicated plugin worktree for a branch
36+
scripts/humanize-plugin-worktree.sh ensure --branch main
37+
scripts/humanize-plugin-worktree.sh ensure --branch feat/refine-plan
38+
39+
# Launch Claude against a target project with the selected plugin branch
40+
scripts/humanize-plugin-worktree.sh launch --branch main --project /path/to/target-project
41+
scripts/humanize-plugin-worktree.sh launch --branch feat/refine-plan --project /path/to/target-project
42+
```
43+
44+
Why this is better:
45+
46+
- No repeated `/plugin install` step when switching plugin branches
47+
- Each branch gets a stable, dedicated plugin path
48+
- The bundled `statusline.sh` now shows `Plugin: <branch>@<commit>` so you can immediately tell which Humanize branch Claude is running
49+
50+
Useful helpers:
51+
52+
```bash
53+
# Show all Humanize repo worktrees
54+
scripts/humanize-plugin-worktree.sh list
55+
56+
# Inspect the plugin identity for a worktree or install copy
57+
scripts/humanize-plugin-worktree.sh info --plugin-dir ~/.claude/plugin-sources/humanize-worktrees/feat_refine-plan
58+
```
59+
2960
## Option 3: Try Experimental Features (dev branch)
3061

3162
The `dev` branch contains experimental features that are not yet released to `main`. To try them locally:

0 commit comments

Comments
 (0)