GH-ISSUE-DEVELOP(1)

✨ NAME ✨

ok so this is gh-issue-develop — the GitHub CLI manual page for it, bestie — and it's literally all about managing linked branches for an issue 💅

---

🌸 SYNOPSIS 🌸

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

so you either hit it with an issue number or a URL, and then sprinkle flags on top. that's the whole vibe check 🦋

---

🎀 DESCRIPTION 🎀

Manage linked branches for an issue. that's it, that's the girlboss job 👑

now the important part, so listen up 🫶 — when you use the --base flag, the new development branch gets created from the specified remote branch. and that new branch? it gets configured as the base branch for pull requests you create using gh pr create. so like, it's not just some random branch floating around, it's got main character energy in your PR flow ✨

---

💖 OPTIONS 💖

• -b, --base <string> — the name of the remote branch you want your shiny new branch to be created from 🌱
• --branch-repo <string> — the name or URL of the repository where you want your new branch to live 🏠
• -c, --checkout — checks out the branch after it's created, so you're instantly on it, no cap ✨
• -l, --list — lists the linked branches for the issue. very "let me see what we're working with" of you 🔍
• -n, --name <string> — the name of the branch to create 🏷️
• --worktree <path> — checks out the branch into a worktree at the given path. yes, a worktree. fancy fr fr 🌳

---

🦋 OPTIONS INHERITED FROM PARENT COMMANDS 🦋

• -R, --repo [HOST/]OWNER/REPO — select another repository using the [HOST/]OWNER/REPO format. gotta know which repo you're in, iykyk 🌈

---

⭐ 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, bestie 💜

---

💀 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 🧚

• gh-issue(1) — go read that one too, it's giving parent command 👑

---

that's the whole page, bestie 💖 this was GitHub CLI v2.102.0, dated Oct 2026 — go forth and link those branches, you're literally gonna slay 🌸🫶