Skip to main content
Claude Board can automatically create git branches and pull requests for each task, keeping your repository organized.

Auto Branch

When enabled, moving a task to In Progress creates a new git branch based on the task title:
Task: "Add user authentication with JWT"
Branch: feature/add-user-authentication-with-jwt
Branch names are generated by:
  1. Taking the task title
  2. Converting to lowercase
  3. Replacing spaces and special characters with hyphens
  4. Prepending the task type (feature/, bugfix/, refactor/, etc.)
The branch is created from the configured base branch (default: main). Change this in project settings if your project uses a different trunk branch.

Auto Pull Request

When a task moves to Testing, Claude Board can automatically create a pull request:
  • Title — the task title
  • Body — the task description
  • Base — the configured base branch
  • Head — the auto-created task branch
Auto PR requires the gh CLI to be installed and authenticated on the machine running Claude Board.

Configuration

Configure git automation in your project settings:
SettingDefaultDescription
Auto BranchOffCreate branches automatically
Auto PROffCreate PRs when task enters Testing
Base BranchmainThe branch to create feature branches from

Manual Override

If auto-branch is disabled, Claude agents still run in the project’s working directory. You can manually create branches before starting a task, or let Claude create them as part of its work via the prompt instructions.