Advanced AI Coding Agent for VS Code — Multi-provider AI assistant with live file writes, terminal commands, and full workspace awareness.
Andor is an intelligent AI coding assistant embedded in VS Code. Unlike typical chatbots, Andor is a proactive agent that understands your entire codebase and can take real actions:
- Read & understand your entire workspace (100+ files)
- Write and modify files automatically during AI streaming
- Run terminal commands (build, test, install, git)
- Debug errors with full diagnostic context
- Refactor safely across multiple files without breaking dependencies
- Continue complex tasks across multiple prompts with checkpoints
- Puter.js — Free tier with Claude, GPT-4o, Gemini, DeepSeek, Llama (no API key needed)
- NVIDIA NIM — High-performance models (Kimi K2, DeepSeek, Llama, Qwen, Codestral)
- OpenRouter — Access to 100+ AI models
- Google Gemini — Direct Gemini API support
- Custom Providers — Bring your own API keys
- Live File Writes — Files are written instantly as AI streams
write:pathblocks (no manual Apply needed) - Terminal Integration — Execute commands with live output display
- Smart Context Assembly — Automatically includes relevant files, filtered by relevance score
- Full Workspace Awareness — AI sees your complete file tree (grouped by directory)
- Diagnostics Integration — Real-time errors and warnings in context
- Multi-file Coordination — AI understands dependencies and updates all affected files
- Senior-Agent Execution — Agents now reason in a structured workflow with analysis, plan, execution, verification, blockers, and completion states
- Better Orchestration — Complex requests can be decomposed into higher-quality sub-tasks with clearer verification and blocker reporting
- Memory Management — Learned patterns and project context
- Workspace Indexing — Full project indexing with progress tracking
- API Key Management — Secure storage for all provider keys
- Web Search — Brave Search API integration for documentation lookup
- Vision Support — Image processing capabilities
- Checkpoints — Auto-saved conversation states, revert anytime
- Task Completion Detection — AI knows when work is done
- Continue Button — Resume multi-step operations
- Prompt Editing — Edit and resend previous messages
- Command Approval — Safety controls for destructive commands
- Agent Mode — Full capabilities: files, terminal, edits
- Chat Mode — Discussion only, no file modifications
- Thinking Mode — Step-by-step reasoning before acting
Search "Andor" in VS Code Extensions and click Install
# Clone the repository
git clone https://github.com/mutheejj/andor.git
cd andor
# Install dependencies
npm install
# Build the webview UI
cd webview-ui && npm install && npm run build && cd ..
# Compile the extension
npm run compile
# Run in development mode
F5 # Opens a new VS Code window with the extension loaded-
Open Andor: Click the Andor icon in the left sidebar or run
Andor: Open Chatfrom the command palette -
Choose a Model: Select from Puter (free), NVIDIA, OpenRouter, or configure your own API keys
-
Start Coding:
- "Refactor this component to use hooks"
- "Fix the TypeScript errors in src/utils"
- "Create a new API endpoint for user authentication"
- "Run npm test and fix any failing tests"
-
Watch it work: Andor analyzes, plans, writes files, and runs commands automatically
"Convert all class components in src/components to functional components with hooks"
Andor will:
- Scan all files in src/components
- Identify class components
- Plan the conversion
- Write updated files in dependency order
- Update imports across all affected files
- Run build to verify
"I'm getting a 'Cannot find module' error when importing utils"
Andor will:
- Check your imports and file structure
- Look at real-time diagnostics
- Examine the workspace index for file locations
- Suggest or apply fixes
- Run the build to verify
"Add a dark mode toggle to the settings page"
Andor will:
- Find the settings component
- Add the toggle UI
- Implement state management
- Apply theme changes
- Update related files
"Run the test suite and tell me what's failing"
Andor will:
- Execute
npm testor your test command - Parse the output for errors
- Identify failing tests
- Suggest fixes or apply them directly
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ VS Code │────▶│ Extension Host │────▶│ AI Providers │
│ Webview UI │◄────│ (Node.js) │◄────│ (Puter, │
│ (React) │ │ │ │ NVIDIA, etc) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ Workspace │ │ File System │
│ Indexer │ │ & Terminal │
└─────────────────┘ └─────────────────┘
- Webview UI: React + TypeScript + Tailwind CSS with streaming support
- Extension Host: VS Code API, file system, terminal access, SecretStorage
- Workspace Indexer: Full project indexing with language detection
- Context Assembler: Intelligent file scoring and selection
- Provider Registry: Multi-provider model management with fallback
- Structured responses: internal agents are guided to produce
Analysis,Plan,Execution,Verification,Blockers, andCompletion - Completion states: work is explicitly marked as
COMPLETE,INCOMPLETE, orBLOCKED - Improved planning: the orchestrator uses stronger complexity detection and creates more disciplined research/debug/test/review task splits
- Verification-first output: multi-agent runs now summarize execution status, verification notes, and blockers instead of returning loosely combined text
- Open Andor Settings (⚙ icon)
- Navigate to the provider tab
- Enter your API key (securely stored in VS Code SecretStorage)
- Test the connection
- Puter — Free tier available, sign in with Puter account
- NVIDIA NIM — Requires NVIDIA API key (free tier available)
- OpenRouter — Requires OpenRouter API key
- Google Gemini — Requires Gemini API key
- Memory: Enable/disable learned context
- Indexing: Auto-index on startup, manual reindex
- Context Limits: Configure max files and relevance thresholds
- Command Approval: Destructive commands (rm, git push) require approval
- Allowlist: Auto-approve frequently used safe commands
- Secure Storage: API keys stored in VS Code SecretStorage
- Live Writes: Files written immediately with undo support via checkpoints
- No Data Leakage: Code context never leaves your machine except to chosen AI provider
We welcome contributors! See CONTRIBUTING.md for guidelines.
- New AI Providers: Add support for additional AI services
- UI Improvements: Themes, layouts, accessibility
- Language Support: Better parsing for Python, Go, Rust, etc.
- Testing: Unit and integration tests
- Documentation: Guides, examples, tutorials
# Build the webview
npm run build:webview
# Compile the extension
npm run compile
# Create a production bundle
npm run packageTo publish to the VS Code Marketplace, use vsce publish after authenticating with your publisher credentials or Personal Access Token.
- Multi-provider Support — NVIDIA, OpenRouter, Gemini
- Live File Writes — Auto-apply during streaming
- Full Workspace Indexing — 100+ file awareness
- Advanced Settings Panel — Memory, indexing, API keys
- Terminal Integration — Command execution with output
- Checkpoints — Conversation state management
- Git Integration — Commit, branch, PR descriptions
- Test Generation — Auto-generate unit tests
- Code Review — Review PRs and suggest improvements
- Custom Skills — Teach Andor your codebase patterns
- Voice Input — Speak your requests
- Offline Mode — Local model support
MIT — Open source, free to use, modify, and distribute.
- Puter — AI infrastructure and API
- VS Code — Extension platform
- NVIDIA — NIM API for high-performance models
- OpenRouter — Unified AI model access
- Contributors — Everyone who helps make Andor better
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: johnmuthee547@gmail.com
- X/Twitter: @mutheejohnke
- GitHub: @mutheejj
Built with ❤️ by developers, for developers