Unhelpful 'An unknown git error occurred' when github: plugin source is 404 #54483

Activity

1. opencode-agent commented on Oct 11, 2026

   

   opencode-agentBot

   on Oct 11, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the detailed report! I could reproduce this on 2.0.26, and it still happens on the latest dev (e31136b).

   With a clean config, running opencode plugin add "github:anomalyco/opencode-ios#main::path:packages/notify-plugin" exits with only:

   NpmInstallFailedError:
     [cause]: Error: An unknown git error occurred
   

   Running git ls-remote against the same URL gives a real git error, but OpenCode doesn't show it. It looks like the git library OpenCode uses (npm's @npmcli/git) gives every failure it doesn't recognize this generic message. Git's actual output is only stored on the error object, and OpenCode's install error never prints it. The script below reproduces it.

   Related: #50080 and PR #50252 (adding the cause to NpmInstallFailedError). For git failures that would still only show the generic message, so git's own output needs to be shown as well.

   Reproduction script (repro.sh)

   #!/usr/bin/env bash
   # Reproduces #54483: installing a github: plugin whose repo does not exist
   # fails with "An unknown git error occurred" and hides git's real error.
   # Usage: ./repro.sh                 (uses `opencode` from PATH)
   #        OC_DEV=/path/to/checkout ./repro.sh   (runs from source)
   set -u
   WORK=$(mktemp -d)
   export HOME=$WORK XDG_CONFIG_HOME=$WORK/.config XDG_CACHE_HOME=$WORK/.cache \
     XDG_DATA_HOME=$WORK/.local/share XDG_STATE_HOME=$WORK/.local/state
   cd "$WORK"
   SPEC="github:anomalyco/opencode-ios#main::path:packages/notify-plugin"
   
   if [ -n "${OC_DEV:-}" ]; then
     OC=(bun --conditions=browser --preload="$OC_DEV/packages/tui/node_modules/@opentui/solid/scripts/preload.js" "$OC_DEV/packages/cli/src/index.ts")
   else
     OC=(opencode)
   fi
   
   echo "== opencode version: $("${OC[@]}" --version)"
   echo "== what git itself says:"
   GIT_TERMINAL_PROMPT=0 git ls-remote https://github.com/anomalyco/opencode-ios.git HEAD 2>&1
   echo "== opencode plugin add $SPEC"
   "${OC[@]}" plugin add "$SPEC" 2>&1
   echo "== exit code: $?"

   Run it: bash repro.sh
2. opencode-agent

   added

   reproduced

   on Oct 11, 2026
3. liudongyan13701205717-source commented on Oct 11, 2026

   

   liudongyan13701205717-source

   on Oct 11, 2026

   More actions

   I'd like to take this. Traced the swallow to packages/util/src/npm.ts: reify() wraps every arborist.reify failure into NpmInstallFailedError with the raw npm error as cause, and for git specs @npmcli/git reduces anything it doesn't recognize to "An unknown git error occurred" while keeping git's real stderr on the error object — which we never print. Plan: unwrap that stored output when constructing the error in reify (and check) so the surfaced message shows the actual cause, e.g. repository 'https://github.com/anomalyco/opencode-ios.git/' not found. This picks up where #50252 left the git-failure case.
4. Tarquinen

   closed this as completedin #62261on Nov 7, 2026