Skip to main content
When enabled, Claude Board automatically creates a GitHub pull request when a task finishes successfully. No manual git push or PR creation needed.

​
Setup

Install GitHub CLI

Install gh and authenticate:
gh auth login

Enable Auto PR

In Project Settings > Git, enable Auto PR and set your Base Branch (default: main).

Done

Every completed task will now automatically push its branch and create a PR.

​
How It Works

When a task completes successfully:

Push branch

Branch is pushed to origin: git push -u origin <branch>

Create PR

PR created via gh pr create with:
  • Title: {task_type}: {task_title} (e.g., “feat: Add JWT auth”)
  • Body: Task description, task key, type, and model used
  • Base: Project’s configured base branch
  • Head: Task’s feature branch

Link saved

PR URL is saved to the task and visible in the Task Detail modal.

​
Branch Cleanup

Auto PRBranch Behavior
EnabledBranches are preserved to keep PRs functional
DisabledCompleted task branches are automatically deleted (local + remote)

​
Requirements

  • gh CLI installed and authenticated (gh auth status to verify)
  • Repository has a GitHub remote (git remote -v should show a GitHub URL)
  • Auto-branch is enabled (task must have created its own branch)
  • Task completed successfully (failed tasks don’t create PRs)
Auto PR works with the orchestration engine. When tasks complete in waves, each task creates its own PR independently.