Codoo AI 🚀

The Privacy-First, Agentic Coding Assistant for VS Code.

Codoo AI is a high-performance, local-first assistant that understands your entire project structure using AST mapping. It brings the power of agentic reasoning to your local machine, keeping your code secure while providing deep-context help.

🚀 Getting Started

Getting Codoo AI up and running takes less than a minute:

1. Install the Extension: Download Codoo AI from the VS Code Marketplace.
2. Open the Sidebar: Click the Codoo icon in your left Activity Bar, or click the 🤖 Codoo button in your bottom right Status Bar.
3. Open a Workspace: Codoo needs a project to analyze. Open any folder or workspace in VS Code.
4. Index Your Project: Click the "Rescan Project" button at the top of the Codoo sidebar. Codoo will perform a blazing-fast, 0-token local scan to build an Abstract Syntax Tree (AST) of your files and functions.
5. Start Chatting: Type a request in the chat box, or open a file and click one of the Quick Action intents (like ✨ Explain Code or 🐛 Fix Bug).

⚙️ Configuration & Model Selection

Codoo AI is completely LLM-agnostic. You can use it 100% locally for free, or connect it to powerhouse cloud models.

Click the Gear Icon in the Codoo sidebar to open the Settings Modal:

• Local AI (Free & Private): Ensure Ollama is running on your machine. Open Settings, and Codoo will automatically detect your installed local models (like llama3 or deepseek-coder).
• Cloud AI (Gemini, OpenAI, Claude): Navigate to the API Keys tab. Paste your API key for your preferred provider. Codoo will instantly fetch and populate the dropdown with the latest available models (e.g., gemini-1.5-pro, gpt-4o, claude-3.5-sonnet).
• Custom Endpoints (LM Studio, Groq, vLLM): Using an alt-API? Enter your Custom Endpoint URL and optional Bearer token in the settings, and type in your custom Model ID.

⚡ Pro Tip: The Quick Switcher Don't want to open settings every time? Use the Quick Model Selector at the very bottom of the chat window to instantly swap between local and cloud models mid-conversation. Use a fast local model for scaffolding, and switch to a heavy cloud model for complex bug fixing!

🤖 Core Capabilities

Codoo isn't just a chatbot; it is a multi-pass Agentic Loop. Here is what it can do for you:

• Zero-to-One Scaffolding: Ask Codoo to build an app, and it will generate a proposed file tree and provide ✨ New File buttons to write the code directly to your hard drive.
• Context-Aware Refactoring: Because Codoo maps your workspace, if you ask "What does processPayment do?", it automatically searches your files behind the scenes, reads the exact function, and explains it to you without you ever pasting the code.
• Smart File Editing: No more copying and pasting. Codoo generates targeted diffs. Review the changes and click Apply to inject them safely into your files. Made a mistake? Just click Undo.
• Intent-Based Token Optimization: Clicking the ✨ Explain Code button temporarily disables editing rules, saving you thousands of input tokens and speeding up response times.
• Self-Healing Code: If Codoo writes a bug, just highlight it, click 🐛 Fix Bug, and tell it what went wrong. It will surgically replace only the broken lines.

📊 Performance & Benchmarks

Codoo AI isn't just a chatbot; it’s a context-aware agent. We tested Codoo against a complex dummy project to measure its architectural reasoning and precision.

Benchmark Results (Qwen2.5-Coder:7B + Codoo AI)

✨ Key Features

1. 🛑 100% Controlled Code Edits (No Background Tampering)

Unlike other AI agents that silently rewrite your workspace until the code is irreversibly broken, Codoo generates precise diff blocks for you to review. Each change comes with your confirmation, preventing unwanted changes and keeping you completely in the driver's seat.

2. ✨ Instant File Creation

From scaffolding new modules to creating complex logic files, Codoo handles the file system for you. One click, and your new files are ready.

3. 🛠️ Intelligent Preference Options

Unsure which framework to use? Codoo analyzes your request and offers context-aware options (like React vs. Vanilla or Flask vs. Django) so you don't have to guess.

4. 🧠 Deep Project Context (AST Mapping + Coustom Algos)

Unlike basic assistants, Codoo uses Abstract Syntax Trees (AST) to map your functions and classes. It only pulls the context it needs, saving tokens and providing hyper-accurate answers.

🔒 Privacy & Security

Codoo operates with a local-first philosophy. When using the Ollama provider, your source code never leaves your machine. No telemetry or code snippets are collected by the extension.

☕ Support the Developer

Codoo is free to use. If it helps your workflow, consider buying me a coffee!

Codoo AI is developed by Manoj R. Thakur.

As an electronics professional and software architect, I’ve built over 40+ free web tools and AI applications. My mission is to bridge the gap between hardware and software while keeping your data private and your workflow efficient.

Developing agentic AI tools requires significant research, high-end hardware testing (shoutout to my RTX 4070!), and—most importantly—coffee. If my tools have saved you time or helped you solve a complex bug, consider supporting my journey!

Why Support?

• ⚡ Powers the development of Codoo's local AST engine.
• 🛠️ Helps maintain my library of 40+ free engineering tools.
• 🇮🇳 Supports independent Indian AI innovation.

Developed by Manoj R. Thakur