CodeBuddy: AI-Powered Agentic Coding Assistant

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.

✨ What's New in v3.7.x

🤖 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

🏗️ Architecture Overview

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

🤖 Agentic System

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

🗄️ Hybrid Storage Architecture

CodeBuddy uses a sophisticated three-tier storage system:

🎯 Core Features

🧠 AI-Powered Developer Agent

• 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

💬 Interactive Chat Interface

• 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 Intelligence

• 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

📊 Mermaid Diagram Support

• 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

🔄 Pull Request Review

• 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

📚 Documentation Generation

• 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

🌐 Web Search Integration

• 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

🚀 Quick Start

Installation

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

Setup

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!

Getting Your API Keys

📋 How to Use

Right-Click Context Menu

Right-click on selected code to access:

⌨️ Keyboard Shortcuts

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

Command Palette

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

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

🔧 Configuration

AI Model Selection

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

API Keys

{
  "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"
}

UI Customization

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

📁 Project Structure

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

🔌 Supported AI Models

🚀 Roadmap

✅ Completed

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

🔜 Coming Soon

• [ ] 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

🛠️ Troubleshooting

Common Issues

❓ 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

Getting Help

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

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

# 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

📊 Technical Specs

• 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

📄 License

MIT License - see LICENSE for details.

🌟 Support the Project

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!