[BUG] Plugin dependency version doesn't work at all

Status Fixed / completed
Maintainer reply ✓ Yes — stbenjam
Activity 3 comments · opened Jun 1, 2026 · closed Jun 2, 2026
💡 Likely answer: A maintainer (stbenjam, contributor) responded on this thread — see the highlighted reply below.

Summary

The plugin dependency version resolution system (using git tags like {name}--v{version}) does not work at all.

I have tested this on v2.1.159

Current Behavior

I created a plugin with a specific dependency:

$ cat ./plugins/bundle-test/.claude-plugin/plugin.json 
{
  "name": "bundle-test",
  "version": "0.1.0",
  "description": "Test plugin for bundled dependencies",
  "author": {
    "name": "stbenjam"
  },
  "dependencies": [
    {
      "name": "jira",
      "marketplace": "ai-helpers",
      "version": "=0.5.0"
    }
  ]
}

Expected Behavior

The plugin loader should:

  1. Read the dependency version constraint (jira version 0.5.0)
  2. Check if a git tag jira--v0.5.0 exists in the openshift-eng/ai-helpers marketplace
  3. Check out/extract that specific version to satisfy the dependency
  4. Install the correct version

This should work regardless of whether the plugins are being installed from a remote repository or from a local git repository.

Steps to Reproduce

$ export CLAUDE_CONFIG_DIR=$(mktemp -d)
$ claude plugin marketplace add stbenjam/temp-marketplace
$ claude plugin marketplace add openshift-eng/ai-helpers 
$ claude plugin install bundle-test@test-marketplace

Expected Results

0.5.0 gets installed (which is the hard dep of "bundle test"

Actual Results

The latest version is installed (0.6.0)

Installed plugins:

  ❯ bundle-test@test-marketplace
    Version: 0.1.0
    Scope: user
    Status: ✘ failed to load
    Error: Requires "jira@ai-helpers" 0.5.0, installed 0.6.0

  ❯ jira@ai-helpers
    Version: 0.6.0
    Scope: user
    Status: ✔ enabled

Why This Matters

The docs say this works. It doesn't. https://code.claude.com/docs/en/plugin-dependencies#tag-plugin-releases-for-version-resolution

Note: I have tried both "=0.5.0" and "0.5.0" by itself.

View original on GitHub ↗

3 Comments

stbenjam contributor · 4 months ago

Not fixed in 2.1.160, bot seems to jump the gun

<img width="724" height="460" alt="Image" src="https://github.com/user-attachments/assets/75285ec2-3b84-486e-8dad-fed56cfdb99b" />

stbenjam contributor · 4 months ago

It appears to be partially fixed, but it is broken when using local git repositories.

github-actions[bot] · 2 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.