Feature: Repository-level plugin recommendations (like VS Code's extensions.json)
Feature Request: Repository-level Plugin Recommendations
Add support for repository-level plugin recommendations, similar to VS Code's .vscode/extensions.json workspace extension recommendations.
Use Case
When a developer clones a repository that uses specific Claude Code plugins, they should be prompted to install those plugins automatically - just like VS Code suggests workspace extensions.
Example scenario:
- Repository uses the
todoplugin for task management - Co-developer clones the repo and opens it in Claude Code
- Claude Code detects
.claude/recommended-plugins.json - Claude Code checks if
todoplugin is installed - If not installed → Shows UI prompt: "This project recommends the 'todo' plugin. Install?"
Proposed Implementation
Configuration File: .claude/recommended-plugins.json
{
"recommendations": [
"todo@codemedic",
"code-review@superpowers",
"github-pr@core"
],
"unwantedRecommendations": [
"legacy-plugin@old-author"
]
}
User Experience
On repository open:
┌─────────────────────────────────────────────────────┐
│ This workspace recommends plugins │
│ │
│ ☐ todo@codemedic │
│ Markdown-based TODO management │
│ │
│ ☐ code-review@superpowers │
│ Code review workflows │
│ │
│ [Install Selected] [Install All] [Don't Show] │
└─────────────────────────────────────────────────────┘
Settings:
claude.plugins.ignoreRecommendations- Disable all workspace recommendationsclaude.plugins.showRecommendationsOnlyOnce- Don't re-prompt after dismissal
Alternative Configuration Locations
Could also support:
- In
plugin.json(for plugin authors to recommend complementary plugins) - In
CLAUDE.md(using frontmatter or a dedicated section) - In
.claude/config.json(workspace-level settings)
Comparison to VS Code
VS Code's .vscode/extensions.json:
{
"recommendations": ["ms-python.python", "ms-toolsai.jupyter"],
"unwantedRecommendations": ["ms-vscode.csharp"]
}
Claude Code should have equivalent functionality for the plugin ecosystem.
Benefits
- Onboarding - New team members automatically get the right plugins
- Consistency - Entire team uses the same tooling
- Discovery - Developers learn about useful plugins for specific workflows
- Documentation - The recommended plugins list serves as implicit documentation of project tooling
Related Features
This could be extended to:
- Plugin version constraints (
"todo@codemedic": ">=1.0.0") - Required vs optional recommendations (warning vs info)
- Auto-install mode for CI/CD environments
- Organization-level plugin policies
Why This Matters
Many projects have specific workflows that depend on Claude Code plugins (task management, code review, deployment). Without repository-level recommendations, every developer must:
- Discover which plugins the team uses
- Manually search the marketplace
- Remember to install them
This creates friction and inconsistency across teams.
---
Related to: #25150 (plugin namespace display issue)
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗