> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claboard.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Git Automation

> Automatic branch creation and pull requests from tasks

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

<Frame>
  <img src="https://mintcdn.com/bahri/LhHfZeA1RQn4U7C6/images/feature-git.svg?fit=max&auto=format&n=LhHfZeA1RQn4U7C6&q=85&s=834ddc6b57d7acc29b9a5872e6089943" alt="Git Automation" width="900" height="260" data-path="images/feature-git.svg" />
</Frame>

## 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.)

<Tip>The branch is created from the configured **base branch** (default: `main`). Change this in project settings if your project uses a different trunk branch.</Tip>

## 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

<Note>Auto PR requires the `gh` CLI to be installed and authenticated on the machine running Claude Board.</Note>

## Configuration

Configure git automation in your project settings:

| Setting     | Default | Description                                |
| ----------- | ------- | ------------------------------------------ |
| Auto Branch | Off     | Create branches automatically              |
| Auto PR     | Off     | Create PRs when task enters Testing        |
| Base Branch | `main`  | The 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.