What it does
Branch Name Generator takes a plain-English description of a task — or an issue title copied from GitHub or Jira — and converts it into a clean, kebab-case branch name with the appropriate type prefix. It strips stop words, normalises special characters, and enforces a configurable maximum length so names stay readable in terminals and PR lists.
When a Jira ticket ID is detected in your input or your current branch, the plugin prepends it automatically so your branch satisfies team-level naming conventions without any manual effort.
- Converts free-form text to
type/kebab-case-descriptionformat - Detects Jira ticket IDs in input and branch context
- Supports configurable prefixes:
feat/,fix/,chore/,docs/,refactor/ - Maximum length enforcement with smart truncation
- GitHub Issue number detection from URLs or bare references
How to install
terminal
npx plugins add branch-namer
Configuration
Customise prefix patterns and length limits in your .claude/plugins.json.
.claude/plugins.json
{
"branch-namer": {
"default-prefix": "feat",
"max-length": 50,
"jira-prefix": true,
"separator": "-"
}
}
Example usage
example — free-form input
# User prompt
Branch for: fix login timeout on mobile
plugin output
fix/login-timeout-mobile # With Jira ID detected: fix/AUTH-234-login-timeout-mobile
Tip: You can paste a full Jira issue URL and the plugin will extract the ticket ID and title automatically, saving you the copy-paste step.