feat: v1.3.0 — Claude Code 2.1.49 productivity improvements #18
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,27 @@ | ||
| { | ||
| "$schema": "https://json.schemastore.org/claude-code-settings.json", | ||
| "permissions": { | ||
| "allow": [ | ||
| "Bash(npm run lint)", | ||
| "Bash(npm run typecheck)", | ||
| "Bash(npm test)", | ||
| "Bash(npm test -- *)", | ||
| "Bash(pnpm run lint)", | ||
| "Bash(pnpm run typecheck)", | ||
| "Bash(pnpm test)", | ||
| "Bash(pnpm test -- *)", | ||
| "Bash(yarn lint)", | ||
| "Bash(yarn typecheck)", | ||
| "Bash(yarn test)", | ||
| "Bash(yarn test -- *)", | ||
| "Bash(pytest)", | ||
| "Bash(pytest *)", | ||
| "Bash(go test ./...)", | ||
| "Bash(go test *)", | ||
| "Bash(git worktree *)", | ||
| "Bash(git status)", | ||
| "Bash(git diff *)", | ||
| "Bash(git log *)" | ||
| ] | ||
| } | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -2,54 +2,78 @@ | |
|
|
||
| Set up parallel Claude Code sessions using git worktrees. | ||
|
|
||
| ## Native Worktree Mode (Claude Code 2.1.49+) | ||
|
|
||
| Claude Code now has built-in worktree support: | ||
|
|
||
| ```bash | ||
| claude --worktree | ||
| claude -w | ||
| ``` | ||
|
|
||
| This creates an isolated git worktree automatically and runs Claude inside it. No manual setup needed. | ||
|
|
||
| ### Subagent Worktree Isolation | ||
|
|
||
| Subagents can also run in isolated worktrees: | ||
|
|
||
| ```yaml | ||
| # In .claude/agents/my-agent.md frontmatter | ||
| isolation: worktree | ||
| ``` | ||
|
|
||
| This gives each subagent its own working copy, preventing file conflicts. | ||
|
|
||
| ## Current State | ||
|
|
||
| ```bash | ||
| git worktree list | ||
| ``` | ||
|
|
||
| ## Manual Worktree Setup | ||
|
|
||
| For cases where you want more control: | ||
|
|
||
| ```bash | ||
| git worktree add ../[project]-feat [branch-name] | ||
| git worktree add ../[project]-fix [branch-name] | ||
| git worktree add ../[project]-exp -b experiment | ||
| ``` | ||
|
|
||
| ## Usage Pattern | ||
|
|
||
| ``` | ||
| Terminal 1: ~/project → Main work (or `claude`) | ||
| Terminal 2: ~/project-feat → claude --worktree (auto-isolated) | ||
| Terminal 3: ~/project-fix → claude -w (shorthand) | ||
| ``` | ||
|
|
||
| Each worktree runs its own Claude session independently. | ||
|
|
||
| ## When to Use | ||
|
|
||
| | Scenario | Recommended Approach | | ||
| |----------|---------------------| | ||
| | Quick parallel task | `claude -w` (auto worktree) | | ||
| | Tests running | Start feature in worktree | | ||
| | Long build | Debug in parallel | | ||
| | Exploring approaches | Compare 2-3 simultaneously | | ||
| | Review + new work | Reviewer in one, dev in other | | ||
| | Background exploration | Subagent with `isolation: worktree` | | ||
|
|
||
| ## Managing Background Agents | ||
|
|
||
| - `Ctrl+F` — Kill all background agents (two-press confirmation) | ||
| - `Ctrl+B` — Send current task to background | ||
| - Background agents continue running when you press ESC | ||
|
|
||
| ## Cleanup | ||
|
|
||
| ```bash | ||
| git worktree remove ../[project]-feat | ||
| git worktree prune | ||
| ``` | ||
|
|
||
| --- | ||
|
|
||
| **Tip:** `claude -w` is the fastest way to parallelize. Like having a dev team you can clone. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -34,12 +34,14 @@ | |
| }, | ||
| "parallel_sessions": { | ||
| "suggest_worktrees": true, | ||
| "worktree_prefix": "../", | ||
| "native_worktree": true | ||
| }, | ||
| "model_preferences": { | ||
| "quick_fixes": "haiku", | ||
| "features": "sonnet", | ||
| "refactors": "opus", | ||
| "architecture": "opus", | ||
| "debugging": "opus" | ||
| } | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -64,7 +64,7 @@ | |
| "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/session-check.js\"" | ||
| } | ||
| ], | ||
| "description": "Context-aware wrap-up reminders using last_assistant_message" | ||
| }, | ||
| { | ||
| "matcher": "*", | ||
|
|
@@ -135,6 +135,18 @@ | |
| "description": "Save context state before compaction" | ||
| } | ||
| ], | ||
| "ConfigChange": [ | ||
| { | ||
| "matcher": "*", | ||
| "hooks": [ | ||
| { | ||
| "type": "command", | ||
| "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/config-watcher.js\"" | ||
| } | ||
| ], | ||
| "description": "Detect when quality gates or hooks are modified mid-session" | ||
| } | ||
| ], | ||
| "Notification": [ | ||
| { | ||
| "matcher": "*", | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| { | ||
| "name": "pro-workflow", | ||
| "version": "1.3.0", | ||
| "description": "Battle-tested Claude Code workflows with agent teams, smart commit, insights, and searchable learnings", | ||
| "main": "dist/index.js", | ||
| "types": "dist/index.d.ts", | ||
|
|
||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Bash(git worktree *)"pre-approves all worktree subcommands, including destructive ones.The wildcard permits
git worktree add <arbitrary-path>,git worktree remove, andgit worktree prune --expire nowwithout user confirmation. This is intentional for the parallel-worktrees workflow, but consumers of this template who don't use native worktrees may want to scope it to justgit worktree listandgit worktree add. Worth documenting the intentional breadth in a comment or the README so adopters can make an informed choice.🤖 Prompt for AI Agents