CodeBuddy is an advanced AI-powered VS Code extension featuring an agentic architecture with specialized sub-agents, tool orchestration, and multi-model support. It transforms your development workflow with intelligent code assistance, autonomous task execution, and deep codebase understanding.

🤖 Agentic Architecture - DeepAgents-powered autonomous developer agent with specialized sub-agents
🧠 LangGraph Integration - Sophisticated multi-agent orchestration with stateful workflows
🔧 Tool Orchestration - Web search, file operations, and think tools for complex reasoning
📊 Mermaid Diagram Rendering - Visual diagram rendering with auto-fix for LLM syntax errors
🔍 PR Review System - Intelligent pull request analysis with change detection
📚 Persistent Codebase Understanding - SQLite-backed analysis caching across sessions
⚡ Streaming Responses - Real-time token streaming for responsive interactions

CodeBuddy employs a sophisticated multi-agent architecture built on modern AI orchestration patterns:

flowchart TB
    subgraph Extension["🧩 CodeBuddy Extension"]
        subgraph UI["User Interface Layer"]
            Webview["💬 Webview<br/>(React UI)"]
            Commands["⚡ Commands<br/>(Actions)"]
            Orchestrator["🎯 Orchestrator<br/>(Event Publisher)"]
        end
        subgraph AgentLayer["🤖 Agent Service Layer"]
            DeveloperAgent["🧠 Developer Agent<br/>(DeepAgents)"]
            subgraph SubAgents["Specialized Sub-Agents"]
                CodeAnalyzer["🔍 Code<br/>Analyzer"]
                DocWriter["📝 Doc<br/>Writer"]
                Debugger["🐛 Debugger"]
                FileOrganizer["📁 File<br/>Organizer"]
            end
        end
        subgraph Tools["🔧 Tool Provider"]
            WebSearch["🌐 Web<br/>Search"]
            FileTool["📄 File<br/>Tool"]
            ThinkTool["💭 Think<br/>Tool"]
            TavilySearch["🔎 Tavily<br/>Search"]
        end
        subgraph Backends["💾 Backend Systems"]
            Filesystem["📂 Filesystem<br/>(/workspace/)"]
            Store["🗄️ Store<br/>(/docs/)"]
            State["⚡ State<br/>(/ ephemeral)"]
        end
    end
    subgraph External["☁️ External Services"]
        Gemini["Gemini"]
        Anthropic["Anthropic"]
        Groq["Groq"]
        Deepseek["Deepseek"]
        Tavily["Tavily API"]
    end
    Webview --> DeveloperAgent
    Commands --> DeveloperAgent
    Orchestrator --> DeveloperAgent
    DeveloperAgent --> SubAgents
    DeveloperAgent --> Tools
    Tools --> Backends
    Tools --> External

The core of CodeBuddy is built on DeepAgents and LangGraph, providing:

• Developer Agent: Main orchestrating agent with access to tools and sub-agents
• Specialized Sub-Agents:
  • Code Analyzer: Deep code review, architecture analysis, bug detection
  • Doc Writer: Comprehensive documentation generation
  • Debugger: Error investigation with web search for solutions
  • File Organizer: Project structure refactoring and organization

CodeBuddy uses a sophisticated three-tier storage system:

• Autonomous Task Execution: Agent can plan, execute, and verify multi-step tasks
• Tool Usage: Web search, file analysis, and structured thinking capabilities
• Sub-Agent Delegation: Complex tasks are delegated to specialized agents
• Human-in-the-Loop: Optional approval for file write/edit operations

• Modern React UI: Beautiful, responsive chat with syntax highlighting
• Real-time Streaming: Token-by-token response streaming
• Mermaid Diagrams: Visual diagram rendering with auto-fix for syntax errors
• File Upload: Support for PDF, DOCX, CSV, JSON, TXT analysis
• Customizable Themes: Multiple themes to match your preferences

• Code Review: Comprehensive analysis of code quality, security, and best practices
• Refactoring: Context-aware code improvements and restructuring
• Optimization: AI-driven performance enhancement suggestions
• Explanation: Clear explanations of complex code logic
• Comment Generation: Intelligent documentation for your code

• Visual Rendering: Automatic detection and rendering of Mermaid diagrams
• Dark Theme: Beautiful purple-accented dark theme matching VS Code
• Auto-Fix: Intelligent repair of common LLM syntax errors:
  • & symbol conversion to and
  • Smart quote normalization
  • Bracket balancing
  • Sequence/flowchart-specific fixes
• Copy & Collapsible Source: Easy access to diagram code

• Branch Comparison: Compare current branch against any target branch
• Change Detection: Multi-provider fallback for robust change detection
• Comprehensive Analysis: Security, performance, and best practice review
• Git CLI Integration: Direct integration with Git for accurate diffs

• README Generation: Auto-generates professional README files
• API Documentation: Extracts and documents REST endpoints
• Architecture Diagrams: Creates Mermaid diagrams for system visualization
• Component Documentation: Documents classes, interfaces, and modules

• Tavily Search: High-quality search results for current information
• URL Reranking: Prioritizes authoritative sources
• Content Extraction: Readability-based article parsing
• Solution Discovery: Find fixes for errors and best practices

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

1. Select AI Model: Choose your preferred AI provider in settings
2. Add API Key: Configure your API key for the chosen model
3. Start Coding: CodeBuddy is ready to assist!

Right-click on selected code to access:

Note: Customize shortcuts in VS Code's Keyboard Shortcuts settings (Cmd+K Cmd+S / Ctrl+K Ctrl+S)

Access via Ctrl+Shift+P / Cmd+Shift+P:

• CodeBuddy: Generate Documentation
• CodeBuddy: Show Cache Status
• CodeBuddy: Clear Cache
• CodeBuddy: Refresh Analysis
• CodeBuddy: Restart

{
  "generativeAi.option": "Gemini" // or "Groq", "Anthropic", "XGrok", "Deepseek"
}

{
  "google.gemini.apiKeys": "your-gemini-api-key",
  "google.gemini.model": "gemini-2.5-pro",
  "anthropic.apiKey": "your-anthropic-api-key",
  "anthropic.model": "claude-sonnet-4-5",
  "groq.llama3.apiKey": "your-groq-api-key",
  "groq.llama3.model": "llama-3.1-70b-versatile",
  "deepseek.apiKey": "your-deepseek-api-key",
  "tavily.apiKey": "your-tavily-api-key"
}

{
  "font.family": "JetBrains Mono",
  "chatview.theme": "Atom One Dark",
  "chatview.font.size": 16
}

codebuddy/
├── src/
│   ├── extension.ts              # Extension entry point
│   ├── orchestrator.ts           # Event orchestration system
│   ├── agents/
│   │   ├── agentService.ts       # Main agent service
│   │   ├── developer/
│   │   │   ├── agent.ts          # Developer agent (DeepAgents)
│   │   │   ├── prompts.ts        # System prompts
│   │   │   └── subagents.ts      # Specialized sub-agents
│   │   ├── backends/
│   │   │   └── filesystem.ts     # VS Code filesystem backend
│   │   ├── langgraph/
│   │   │   ├── tools/            # LangGraph tool implementations
│   │   │   ├── nodes/            # Graph nodes (planner, responder, etc.)
│   │   │   └── state/            # State management
│   │   └── tools/
│   │       └── provider.ts       # Tool factory and provider
│   ├── commands/                 # VS Code command implementations
│   │   ├── pr/                   # PR review system
│   │   └── *.ts                  # Individual commands
│   ├── services/
│   │   ├── codebase-understanding.service.ts
│   │   ├── documentation-generator.service.ts
│   │   ├── context-retriever.ts
│   │   ├── web-search-service.ts
│   │   ├── embedding.ts
│   │   └── *.ts
│   ├── tools/
│   │   └── tools.ts              # Tool definitions (Web, File, Think)
│   ├── llms/                     # AI provider integrations
│   ├── infrastructure/           # Logging, database, etc.
│   └── webview-providers/        # Webview provider management
├── webviewUi/                    # React chat interface
│   ├── src/
│   │   ├── components/
│   │   │   ├── MermaidDiagram.tsx
│   │   │   ├── thinkingComponent.tsx
│   │   │   └── *.tsx
│   │   └── App.tsx
│   └── package.json
└── package.json                  # Extension manifest

• Multi-model AI support (5 providers)
• Agentic architecture with DeepAgents
• LangGraph integration for orchestration
• Specialized sub-agents (Code Analyzer, Doc Writer, Debugger, File Organizer)
• Web search with Tavily integration
• Mermaid diagram rendering with auto-fix
• PR review system
• Persistent codebase analysis (SQLite)
• Real-time streaming responses
• Keyboard shortcuts

• MCP Integration - Model Context Protocol for enhanced tool usage
• Agent-to-Agent Communication - A2A protocol support
• Local LLM Support - Ollama integration for offline usage
• Multi-language Support - Extended language support
• Team Collaboration - Shared contexts across teams
• Custom Agents - User-defined specialized agents

❓ Agent not responding

• Verify API key is correct in settings
• Check API quota/billing status
• Try a different AI model

❓ Mermaid diagrams not rendering

• Diagrams auto-fix common syntax errors
• Check console for specific parse errors
• Try "Show Source Code" to see raw diagram

❓ PR Review not working

• Ensure you're in a Git repository
• Check that you have multiple branches
• Verify Git CLI is accessible

❓ Slow responses

• Try Groq for faster responses
• Check internet connection
• Clear cache with CodeBuddy: Clear Cache

• 📖 Documentation
• 🐛 Report Issues
• 📧 Contact: oyinolasunkanmi@gmail.com

We welcome contributions! See CONTRIBUTING.md for guidelines.

# Clone the repository
git clone https://github.com/olasunkanmi-SE/codebuddy.git
# Install dependencies
npm install
cd webviewUi && npm install
# Build
npm run compile
cd webviewUi && npm run build
# Run in development
# Press F5 in VS Code to launch extension development host

• Bundle Size: ~9MB (Extension) + ~800KB (UI)
• VS Code Version: 1.78.0+
• AI Models: 5 providers supported
• Database: SQLite for metadata, LanceDB for vectors
• Agent Framework: DeepAgents + LangGraph
• UI Framework: React + styled-components

MIT License - see LICENSE for details.

If CodeBuddy enhances your workflow:

• ⭐ Star the repository
• 📝 Leave a review on the VS Code Marketplace
• 📝 Leave a review on the open-vsx.org Marketplace
• 🐛 Report bugs or suggest features
• 🤝 Contribute to the codebase
• 💬 Share with fellow developers

Made with ❤️ by Olasunkanmi Raymond

Transform your coding experience with AI-powered agentic assistance. Install CodeBuddy today and code smarter, not harder!