GH-ISSUE-DEVELOP(1) GitHub CLI manual GH-ISSUE-DEVELOP(1)

gh-issue-develop - Manage linked branches for an issue

gh issue develop {<number> | <url>} [flags]

Manage linked branches for an issue.

When using the --base flag, the new development branch will be created from the specified remote branch. The new branch will be configured as the base branch for pull requests created using gh pr create.

Name of the remote branch you want to make your new branch from
Name or URL of the repository where you want to create your new branch
Checkout the branch after creating it
List linked branches for the issue
Name of the branch to create

Select another repository using the [HOST/]OWNER/REPO format

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

# List branches for issue 123
$ gh issue develop --list 123
# List branches for issue 123 in repo cli/cli
$ gh issue develop --list --repo cli/cli 123
# Create a branch for issue 123 based on the my-feature branch
$ gh issue develop 123 --base my-feature
# Create a branch for issue 123 and checkout it out
$ gh issue develop 123 --checkout
# Create a branch in repo monalisa/cli for issue 123 in repo cli/cli
$ gh issue develop 123 --repo cli/cli --branch-repo monalisa/cli

gh-issue(1)

Jul 2025