gh stack link --remote <fork> queries the fork’s parent repository
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 68/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- git, github, go
- Domain
- cli, developer-experience
Research direction
Start by reproducing gh stack link --base main --remote fork --open <first-pr> <second-pr> in the multi-remote fork setup, then inspect repository resolution and the .git/gh-stack state. Done means the command uses the fork endpoint, and conflicting repository signals fail before an API request with a clear selection error; add a regression test for this scenario.
Written by the indexing model from the issue text.
Description
Summary
In a fork clone with separate upstream and fork remotes, gh stack link --remote fork queries the stack API for the upstream parent repository instead of the selected fork.
This prevents linking existing PRs when access to the parent is restricted, even though the authenticated user can access the fork and all PRs being linked have both their base and head repositories in the fork.
This appears related to #381, but that report covers gh stack submit selecting origin in a multi-remote clone. This reproduction covers gh stack link, has no origin remote, and shows the extension selecting a fork's parent despite an explicit --remote, remote.pushDefault, and gh-resolved repository.
Environment
gh version 2.100.0 (2026-09-03)gh stack/github/gh-stackv0.1.1- Repository:
<fork-owner>/<repository>, a fork of<upstream-owner>/<repository> - Two existing PRs whose base and head repositories are both the fork
Repository configuration
$ git remote -v
fork git@github.com:<fork-owner>/<repository>.git (fetch)
fork git@github.com:<fork-owner>/<repository>.git (push)
upstream git@github.com:<upstream-owner>/<repository>.git (fetch)
upstream no_push (push)
$ git config --get remote.pushDefault
fork
$ git config --get remote.fork.gh-resolved
<fork-owner>/<repository>
$ gh repo set-default --view
<fork-owner>/<repository>
The local .git/gh-stack state was initialized with the parent repository despite this configuration:
{
"schemaVersion": 1,
"repository": "github.com:<upstream-owner>/<repository>"
}
Steps to reproduce
-
Clone a GitHub fork with one remote for the fork and a separate fetch-only remote for its parent. There is no
originremote. -
Set the fork as the push/default GitHub repository:
git config remote.pushDefault fork git config remote.fork.gh-resolved <fork-owner>/<repository> -
In the fork, create two open PRs intended to form a stack. Both PRs have base and head repositories equal to
<fork-owner>/<repository>. -
Run:
gh stack link --base main --remote fork --open <first-pr> <second-pr>
Actual behavior
The extension calls the parent repository's stack endpoint and fails:
Checking existing stacks...
failed to list stacks: HTTP 403
(https://api.github.com/repos/<upstream-owner>/<repository>/stacks?per_page=100&page=1)
The authentication failure is expected for that parent repository. The unexpected behavior is querying the parent at all.
Expected behavior
gh stack link --remote fork should query and mutate stack metadata in <fork-owner>/<repository>, matching:
- the explicitly selected remote;
remote.pushDefault;- standard
ghrepository resolution; and - the base/head repository of every PR passed to
--open.
If these signals disagree, the extension should fail before making an API request and report which repository needs to be selected.
Controls
The correct fork endpoint is accessible with the same authentication:
gh api 'repos/<fork-owner>/<repository>/stacks?per_page=100&page=1'
# HTTP 200
Running the same link command from a temporary Git repository whose only remote is <fork-owner>/<repository> succeeds:
Created stack with 2 PRs
This isolates the failure to repository resolution in the multi-remote fork clone rather than authentication, PR shape, or stack creation.
Impact
gh stack linkcannot be used normally in this fork/multi-remote layout.- Users may receive misleading authentication errors for a repository they did not select.
- Where the user has access to both repositories, the command may read or write stack metadata in the wrong repository.
Workaround
Run gh stack link from a temporary repository configured with only the fork remote. This is error-prone and loses the normal relationship with the working clone.
Related
- #381 reports the likely shared repository-resolution defect for
gh stack submit. - #461 reports stale fork/parent metadata affecting
gh stack submitafter a remote rename.
If maintainers consider link covered by #381, I am happy for this to be closed as a duplicate; the additional reproduction may still be useful for a regression test.
- Dominant language
- Go
- Stars
- 1.5k
- Forks
- 73
- Avg merge
- 1d 8h
- Merged PRs (30d)
- 7
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from github/gh-stack
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
-
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
feature request topic: cli - general
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
feature request topic: auto-merge
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
bug topic: docs
Difficulty 1/5 Under an hour Newbie friendliness 68/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
NVIDIA/gpu-operator#2955 ·
-
agentic-workflows
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
kovidgoyal/kitty#10516 ·
-
bug
Difficulty 1/5 Under an hour Newbie friendliness 90/100
cisagov/vulnrichment#337 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 72/100