ContextHub (VS Code Extension)
A Visual Studio Code extension that enables teams to manage and share AI assistant catalog resources (chat modes, instructions, prompts, tasks, and MCP servers) across multiple repositories inside VS Code.
✨ Features
- 🗂️ Catalog Management: Organize and manage AI assistant resources across multiple repositories
- 🎭 Chat Modes: Define custom AI assistant personas and behaviors
- 📚 Instructions: Share reusable instruction sets for AI assistants
- 💡 Prompts: Manage and activate prompt templates
- ⚡ Tasks: Define automated task configurations
- 🔧 MCP Integration: Manage Model Context Protocol servers
- 🎩 Hats (Presets): Save and apply resource combinations as presets
- 🔄 Real-time Sync: Automatically sync resources between catalogs and workspaces
- 🎯 Multiple Sources: Support for local directories, workspace folders, and remote URLs
- 🚀 Team Collaboration: Share catalog configurations across development teams
🚀 Quick Start
Installation
Install from VS Code Marketplace: ContextHub
Basic Usage
- Open the ContextHub view in the VS Code Activity Bar.
- Add a catalog directory:
- Click the Options menu → Add Catalog Directory... (recommended), OR
- Open the Dev menu → Open Settings and add paths under the
contexthub.catalogs setting.
- (Optional) Create a template catalog: Dev menu → Create Template Catalog (helpful if you don't already have a catalog).
- Activate resources: Right-click any resource and choose Activate.
- Apply presets (Hats): Use the Hats menu to apply saved resource combinations.
- (Optional) Repeat step 2 to add multiple catalogs (local folders or remote URLs) for aggregation.
Example Catalog Structure
example-catalog/
├── chatmodes/
│ └── developer-assistant.chatmode.md
├── instructions/
│ └── code-review-guidelines.instructions.md
├── prompts/
│ └── bug-analysis.prompt.md
├── tasks/
│ └── automated-testing.task.json
├── mcp/
│ └── development-servers.mcp.json
└── hats/
└── full-stack-dev.json
📖 Documentation
🛠️ Development
Prerequisites
- Node.js 18+
- VS Code 1.90.0+
- TypeScript 5.4+
🤝 Contributing
We welcome contributions! Please see our Contributing Guidelines for details.
Development Process
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Write tests for your changes
- Implement your feature
- Ensure all tests pass:
npm test
- Commit your changes:
git commit -m 'Add amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🔒 Security
If you discover a security issue, please do NOT open a public issue immediately. Instead:
- Reproduce and collect minimal details.
- Contact the maintainer privately (e.g. via the email listed in the repository profile) OR temporarily make a private draft issue.
- After a fix is prepared and released, disclosure can be coordinated.
📞 Support
For support and questions, please see our Support Guide.
🏷️ Versioning
We use Semantic Versioning for release management:
- MAJOR: Breaking changes
- MINOR: New features (backward compatible)
- PATCH: Bug fixes (backward compatible)
🙏 Acknowledgments
- Thanks to the VS Code extension development community
- Inspired by the need for better AI assistant resource management
- Built with ❤️ by independent contributors
Code of Conduct
Please adopt a standard open-source code of conduct (e.g. Contributor Covenant) for community interactions. If one is added, reference it here.
Trademarks
All product names, logos, and brands are property of their respective owners. Use of any third-party trademarks or logos does not imply endorsement.
