useVibe is a powerful VS Code extension that helps you organize project-specific knowledge and seamlessly integrate it with AI assistants like GitHub Copilot, Cursor AI, and other LLM-powered tools.

AI assistants are powerful, but they often:

• 🤷‍♂️ Lack context about your specific project architecture
• 🔄 Forget important patterns and conventions between sessions
• 📚 Can't access your documentation, design decisions, or API specs
• 🎯 Give generic answers instead of project-specific solutions

useVibe creates organized context projects that:

• ✅ Keep project knowledge in dedicated folders (.contexts/)
• ✅ Feed relevant context to your AI assistants automatically
• ✅ Sync with external repositories (docs, SDKs, examples)
• ✅ Track changes and keep documentation up-to-date
• ✅ Work seamlessly with GitHub Copilot Chat via @usevibe participant

Create dedicated knowledge spaces for different aspects of your project:

• Architecture docs - Design decisions and patterns
• API documentation - Endpoint references and examples
• Code templates - Reusable boilerplate and snippets
• External libraries - Clone repos for reference
• Onboarding materials - New developer resources

Use the @usevibe chat participant in VS Code:

@usevibe status              # Overview of all projects
@usevibe tasks               # Show all TODO items
@usevibe plan                # Get AI work plan for today
@usevibe news                # Recent changes across projects
@usevibe sync all            # Update all Git repos
@usevibe @api-docs [query]   # Query specific project

Access features via Command Palette (Cmd+Shift+P):

• Show Project Status - Dashboard of all projects
• Show All TODO Tasks - Scan projects for pending work
• Show Recent Changes - Git commit history
• Sync All Projects - Pull latest updates

• Clone repositories as context projects
• Track changes automatically with visual indicators
• Auto-sync with configurable intervals
• Change analysis with commit summaries
• Update notifications when new commits are available

Import and manage various file types:

• ✅ Markdown (.md)
• ✅ Code files (.ts, .js, .py, .java, etc.)
• ✅ PDF documents
• ✅ Word documents (.docx)
• ✅ Text files (.txt)

• Sidebar view with tree structure
• Enable/disable projects with one click
• Visual indicators for Git changes
• Quick actions via context menus
• Status bar integration for auto-sync

1. Open VS Code
2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
3. Search for "useVibe"
4. Click Install

# Download the latest release
# Then install:
code --install-extension useVibe-vscode-1.0.0.vsix

# For Cursor IDE:
cursor --install-extension useVibe-vscode-1.0.0.vsix

git clone https://github.com/useVibe/useVibe-vscode.git
cd useVibe-vscode
npm install
npm run compile
vsce package
code --install-extension useVibe-vscode-1.0.0.vsix

Open the useVibe view in the sidebar (Activity Bar icon) and click "Create New Project".

Right-click on your project:

• Add Current File - Add the file you're currently editing
• Import Files - Browse and select multiple files
• Create Note - Add markdown documentation

Click "Clone from GitHub" to add external documentation or libraries as reference:

https://github.com/facebook/react
https://github.com/typescript-cheatsheets/react

@usevibe @api-docs how do I authenticate users?

• Press Cmd+Shift+P
• Type "useVibe: Show Project Status"

your-workspace/
├── .contexts/                    # useVibe folder
│   ├── api-docs/                # API documentation project
│   │   ├── endpoints.md
│   │   └── examples.md
│   ├── architecture/             # Architecture decisions
│   │   └── design-patterns.md
│   ├── react-docs/              # Cloned from GitHub
│   │   └── [repo contents]
│   └── .ai-rules                # AI instruction files
├── src/
└── ...

Configure useVibe in your VS Code settings:

{
  // Folder name for context projects
  "useVibe.contextsFolderName": ".contexts",
  
  // Show welcome message
  "useVibe.showWelcomeMessage": true,
  
  // Auto-sync settings
  "useVibe.autoSync.enabled": true,
  "useVibe.autoSync.intervalMinutes": 60,
  "useVibe.autoSync.notifyOnChanges": true
}

Keep design decisions and patterns organized:

.contexts/architecture/
├── design-decisions.md
├── coding-standards.md
└── api-design.md

When Copilot suggests code, it references your architecture docs for consistent patterns.

Clone official documentation:

@usevibe clone https://github.com/openai/openai-python

Now ask: @usevibe @openai-python how do I stream responses?

Create an onboarding project:

.contexts/onboarding/
├── getting-started.md
├── development-setup.md
└── common-pitfalls.md

Organize contexts for microservices:

.contexts/
├── backend-api/
├── frontend-react/
├── mobile-app/
└── shared-types/

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes and add tests
4. Commit: git commit -m 'Add amazing feature'
5. Push: git push origin feature/amazing-feature
6. Open a Pull Request

# Clone the repo
git clone https://github.com/useVibe/useVibe-vscode.git
cd useVibe-vscode

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode for development
npm run watch

# Run in debug mode
# Press F5 in VS Code to open Extension Development Host

npm test

Found a bug or have an idea? Open an issue!

• ✅ Search existing issues to avoid duplicates
• ✅ Include VS Code version and OS
• ✅ Provide clear reproduction steps
• ✅ Include relevant screenshots/logs

This project is licensed under the MIT License - see the LICENSE file for details.

If useVibe helps your development workflow:

• ⭐ Star this repository on GitHub
• 📢 Share with your team and community
• 🐛 Report bugs and suggest features
• 💻 Contribute code or documentation
• ☕ Sponsor the project (coming soon!)

• VS Code Marketplace
• GitHub Repository
• Issue Tracker
• Changelog
• Contributing Guide
• Code of Conduct