gh issue develop checks out a linked branch in a worktree
Introduced 2026-09-01 · score 0.97
HOW TO USE IT
When you need to start issue work in a separate Git working copy, run `gh issue develop` with `--checkout` and `--worktree` to create and check out the linked branch there. The documented example uses issue 123 and `/path/to/wt-feature`.
gh issue develop 123 --checkout --worktree /path/to/wt-featureWHY THIS HELPS
Start work on an issue in a separate Git working copy while preserving the current working copy.
REQUIREMENTS AND LIMITATIONS
- Version: v2.99.0
- <number> (required): Issue number or URL whose linked branch to manage.
- --checkout (required): Check out the branch after creating it.
- --worktree <path> (required): Check out the branch into a worktree at the given path.
- Prerequisite: Authenticate `gh` with `gh auth login` or provide a supported authentication token through an environment variable.
- The new worktree leaves the current working copy unchanged.
FIRST-PARTY EVIDENCE
- https://github.com/cli/cli/releases/tag/v2.99.0
- https://cli.github.com/manual/gh_issue_develop
- https://cli.github.com/manual/index
Check the installed version and the source before using it. Entry JSON