gh-issue-develop(1)

gh-issue-develop1

Manage linked branches for an issue

Usage

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

Overview

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.

Options

-b, --base <string>

Name of the remote branch you want to make your new branch from

--branch-repo <string>

Name or URL of the repository where you want to create your new branch

-c, --checkout

Checkout the branch after creating it

-l, --list

List linked branches for the issue

-n, --name <string>

Name of the branch to create

--worktree <path>

Check out the branch into a worktree at the given path

Options inherited from parent commands

-R, --repo <[HOST/]OWNER/REPO>

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

Exit status

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.

Examples

# 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 check it out
$ gh issue develop 123 --checkout
# Create a branch for issue 123 and check it out in a worktree
$ gh issue develop 123 --checkout --worktree /path/to/wt-feature
# 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

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

--branch-repo since Debian 13 (Trixie); --worktree since Arch Linux 2026-11-01.

--issue-repo until Debian 12 (Bookworm); -i until Debian 12 (Bookworm).

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.