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

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

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](#OPTIONS)

[**-b**, **--base** **<string>**](#b)

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

[**--branch-repo** **<string>**](#branch_repo)

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

[**-c**, **--checkout**](#c)

Checkout the branch after creating it

[**-l**, **--list**](#l)

List linked branches for the issue

[**-n**, **--name** **<string>**](#n)

Name of the branch to create

[**--worktree** **<path>**](#worktree)

Check out the branch into a worktree at the given path

# [OPTIONS INHERITED FROM PARENT COMMANDS](#OPTIONS_INHERITED_FROM_PARENT_COMMANDS)

[**-R**, **--repo** **<\[HOST/\]OWNER/REPO>**](#R)

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

# [EXIT CODES](#EXIT_CODES)

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.

# [EXAMPLE](#EXAMPLE)

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

# [SEE ALSO](#SEE_ALSO)

[**gh-issue(1)**](/man/os/gh/gh-issue.1)

Sep 2026

---

Document: gh-issue-develop(1) from gh 2.102.0-r0 (Chainguard OS)
Source: https://github.com/cli/cli