[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:
- Read the dependency version constraint (
jiraversion0.5.0) - Check if a git tag
jira--v0.5.0exists in the openshift-eng/ai-helpers marketplace - Check out/extract that specific version to satisfy the dependency
- 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.
3 Comments
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" />
It appears to be partially fixed, but it is broken when using local git repositories.
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.