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 branch output is more useful with descriptive names

This should be a global setting (~/.claude/settings.json) so it applies to all projects.

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗