new-branchStandardized Git branch names

A composable CLI to generate and create branch names using a pattern + transform pipeline.

🧩

Pattern Language

Define branch names with a declarative pattern syntax — variables, transforms, and arguments in a single expression.

🔄

Chain transforms like slugify, kebab, max, and replace to shape variable values exactly the way you need.

🚀

Run new-branch init to bootstrap your .newbranchrc.json interactively with live preview — or use --yes for sensible defaults.

⚙️

Configure via .newbranchrc.json, package.json, or git config. CLI flags always take precedence.

🏷️

Define named patterns (feature, hotfix, release) and switch between them with --use.

💬

Missing values are prompted interactively. Disable with --no-prompt for CI environments.

🔍

Use --explain, --list-transforms, and --print-config to understand exactly what the CLI does.

bash

npx new-branch \
  --pattern "{type}/{title:slugify;max:25}-{id}" \
  --type feat \
  --title "Add user authentication" \
  --id PROJ-456

Output:

feat/add-user-authenticatio-PROJ-456

bash

# Run without installing
npx new-branch

# Or install globally
npm install -g new-branch