[BUG] Plugin dependency version doesn't work at all
Resolved 💬 2 comments Opened Jun 1, 2026 by stbenjam Closed Jun 2, 2026
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.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗