Branchwright - Git Branch Name Linting

Features

✨

Frictionless Branch Creation

Smart defaults and minimal prompts for a streamlined workflow. Create branches in seconds without interrupting your flow.

🔍

Branch Name Validation

Lint existing branches against your naming conventions. Enforce consistency across your entire team.

🎯

Extensible Rules System

Built-in rules plus support for custom rule plugins. Adapt to any team's workflow and conventions.

⚙️

Template-Based Naming

Use {{type}}/{{ticket}}-{{desc}} or define any custom format. Full control over branch structure.

🚀

CLI & API

Use as a standalone CLI tool or integrate programmatically into your workflow automation.

📦

TypeScript-First

Full type definitions included. Excellent autocomplete and type safety for configuration.

Quick Example

# Interactive branch creation
brw create

# Validate current branch
brw lint

# Validate all branches
brw lint --all

Why Branchwright?

Just as commitizen and commitlint revolutionized commit message consistency, Branchwright brings the same level of standardization to Git branch names.

The Problem

Inconsistent branch naming across teams
Difficult to understand branch purpose at a glance
Manual enforcement of naming conventions is tedious
CI/CD pipelines struggle with unpredictable branch names

The Solution

Interactive prompts guide developers to create properly named branches
Automated validation prevents non-compliant branches
Configurable rules adapt to any team's workflow
Integrates seamlessly with existing Git workflows

Ready to Get Started?

Install Branchwright and start creating consistent branch names today.

Read the Docs See Examples