Walnut AI - Intelligent Coding Assistant
Walnut AI is a powerful VS Code extension that brings AI-powered coding assistance directly into your development workflow. Chat with AI, understand your codebase, and execute tasks autonomously.
Key Features
Conversational AI Chat
- Natural Language Interface: Ask questions, request code changes, or get explanations in plain English
- Context-Aware: Automatically understands your current file, selection, and workspace
- Multi-Model Support: Works with Claude, GPT-4, GPT-5, Gemini, and other leading AI models
- Extended Thinking: See AI's reasoning process for complex tasks
Autonomous Task Execution
- File Operations: AI can read, write, and edit files across your project
- Terminal Commands: Execute shell commands with approval workflow
- Multi-Step Tasks: Complex operations broken into manageable steps
- Smart Retry: Automatic retry with exponential backoff on transient errors
Dev & QA Modes
- Development Mode: Code quality focused - build features, fix bugs, refactor
- QA Mode: Test automation focused - plan tests, generate Playwright scripts, fix failing tests
- Specialized Agents: Test Planner, Test Generator, Test Healer for QA workflows
Code Intelligence
- Codebase Analysis: AI understands your entire project structure
- Semantic Search: Find code by meaning, not just keywords
- Code Explanation: Get detailed explanations of complex code
- Refactoring: Intelligent code improvements and optimizations
Developer Experience
- Inline Tool Display: See AI actions inline within conversations
- Permission Modes: Ask, Auto, and Plan modes for different workflows
- Session History: Save and restore conversation sessions
- Image Support: Attach screenshots for visual context
- Task Tracking: Built-in todo list for complex tasks
- Model Selector: Choose between multiple AI models or let Auto select
- Credit Tracking: Real-time credit balance for starter/teams plans
- Undo Support: Revert AI changes with git-based snapshots
Getting Started
- Install the extension from VS Code Marketplace
- Open the Walnut AI sidebar (click the Walnut icon in the activity bar)
- Login with your Walnut account at app.walnutai.ai
- Select a project and start chatting!
Usage
Chat Commands
- Type your question or request in the input area
- Use
@ to mention files from your workspace
- Use
/ for quick commands (commit, review, etc.)
Keyboard Shortcuts
| Shortcut |
Action |
Cmd/Ctrl + Enter |
Send message |
Shift + Enter |
New line |
Shift + Tab |
Cycle permission mode |
Escape |
Stop current operation |
Permission Modes
| Mode |
Description |
| Ask |
AI asks for approval before making changes |
| Auto |
AI automatically approves safe operations |
| Plan |
AI explores and plans before executing (read-only) |
QA Agents (QA Mode)
| Agent |
Description |
| Test Planner |
Explores your app and creates comprehensive test plans |
| Test Generator |
Generates production-ready Playwright test scripts |
| Test Healer |
Diagnoses and fixes failing or flaky tests |
Supported AI Providers
- Anthropic Claude (Claude Opus 4.5, Claude Sonnet 4, Claude Haiku 4.5)
- OpenAI (GPT-5, GPT-4o, O3, O4-mini)
- Azure OpenAI (All Azure-hosted models)
- AWS Bedrock (Claude on Bedrock with cross-region support)
- Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)
- Custom Endpoints (Any OpenAI-compatible API)
Configuration
Configure Walnut AI through VS Code settings (Cmd/Ctrl + ,):
| Setting |
Description |
walnut.server.url |
Walnut server URL (default: app.walnutai.ai) |
walnut.playwright.enabled |
Enable Playwright MCP for browser automation |
walnut.playwright.browser |
Browser for automation (chromium/firefox/webkit) |
Requirements
- VS Code 1.98.0 or higher
- Active internet connection
- Walnut AI account (sign up free)
Privacy & Security
- Code is processed securely through your configured AI provider
- File operations require explicit approval in Ask mode
- API keys stored securely via VS Code SecretStorage
- Sensitive environment variables filtered from subprocess execution
- No training on your code without consent
Support
Walnut AI - Your intelligent coding companion
| |