Feature request: configurable worktree branch naming
Resolved 💬 4 comments Opened Feb 15, 2026 by bzsasson Closed Mar 17, 2026
Feature Request
When Claude Code creates git worktrees, it auto-generates branch names using a random adjective-noun pattern (e.g., claude/focused-pare, claude/zen-mendeleev).
Previously, branch names were descriptive of the task (e.g., claude/setup-indexnow-integration-uv4oK), which made it much easier to identify what each branch/PR was for at a glance in GitHub.
Request
Add a setting (e.g., in ~/.claude/settings.json) to control worktree branch naming style. Something like:
{
"worktree": {
"branchNameStyle": "descriptive"
}
}
Options could be:
"descriptive"(default/previous behavior) - generates a name based on the task, e.g.,claude/pause-google-indexing-abc12"random"(current behavior) - random adjective-noun, e.g.,claude/focused-pare
Why This Matters
- PR readability: Descriptive branch names make PRs immediately identifiable in GitHub's PR list
- Multiple worktrees: When juggling several worktrees, random names require checking each one to remember what it's for
- Git history:
git branchoutput is more useful with descriptive names
This should be a global setting (~/.claude/settings.json) so it applies to all projects.
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗