Blue AI Coding Assistant
Unleash Blue's coding-agent workflow directly inside VS Code. Navigate complex codebases, edit files, run tests, recover from common errors, and configure custom MCP servers—all powered by fast, free cloud models.
Key Capabilities
- Durable Blue Engine: Powered by a local background execution engine (
blue-engine.exe) that ensures workspace safety, state persistence, and robust task execution.
- Surgical Code Modifications: Blue edits across multiple files with exact search-and-replace precision, avoiding structural file overwrites.
- Autonomous Build Recovery: When compilation checks or test suites fail, Blue inspects the diagnostics output to self-diagnose and repair errors until they pass.
- AST Explicit Referencing: Tag specific workspace files or symbols in your queries using
@filename syntax, powered by automatic Document Symbol caching.
- Persistent Workspace Memory: Stores project-specific details, port numbers, and conventions in
.vscode/blue_memory.json to keep context consistent across sessions.
- Extensible via MCP: Query and execute tools on stdio Model Context Protocol (MCP) servers (such as
ssh-deploy or browser) to automate deployments.
Modes of Operation
Blue adapts to your workflow with three dedicated modes:
- Inline Autocomplete: Zero-lag inline code suggestions utilizing Fill-in-the-Middle (FIM) templates and localized window context.
- Standard Chat: A sidebar panel that answers engineering questions, explains code, and drafts changes with a single-click apply action.
- Autonomous Agent: An agentic coordinator that loops to solve complex tasks—reading files, applying patches, running tests, and executing deployment scripts.
Guardrails & Safety
To keep you in control and protect your codebase:
- Mutual Consent Gates: Blue halts and requests explicit UI approval before running shell commands or executing write/patch tools.
- Restore Points: Blue records local restore points for supported tool-driven edits so you can roll back from the sidebar when a task goes wrong.
- Approval Gates: Blue asks before sensitive command/edit actions and preserves the active task session when provider limits interrupt execution.
- Verification Checks: Blue runs detected build/test commands after changes and reports whether verification passed before claiming completion.
Getting Started
- Install the extension from the VS Code Marketplace.
- Sign in with your Google account.
- In Blue's Setup Wizard, choose Sign in with OpenCode, connect an OpenRouter API key, or use an eligible Blue API key.
- Start chatting with Blue!
Supported Models
Blue loads the current model catalogue from the selected provider. OpenRouter BYOK supports models available to your OpenRouter account, including free models when offered. Availability, pricing, and capabilities may change; check the provider before choosing a paid model.
OpenCode sign-in uses the OpenCode native engine and your selected workspace's exact available free and paid models. An OpenCode API key is not required. Blue does not send this account credential to OpenRouter or automatically select a paid model. Select a model explicitly after connecting a new workspace. OpenCode inline autocomplete is not enabled; account-backed chat and project tasks use the native engine.
Connections and documents
The Account panel exposes Supabase, the official React Bits catalog, and local Zotero alongside the existing connections. Supabase requires a verified paid Blue plan and browser authorization. React Bits needs Node.js/npm; paid Pro components require their own licence. Zotero requires its local app and an installed MCP server or uv. The UI reports actual connection/setup status; it does not imply that an unconfigured service is connected.
/document exports project Markdown to real Word and PDF files unless a format is excluded. PDF export uses an installed Chrome, Edge, or Chromium browser in a private offline profile. If PDF rendering is unavailable, Blue preserves Word and reports the limitation. /research-paper exports the manuscript staging source to Word. Open buttons are tied to saved project artifacts.
Voice mode remains exclusive to Blue Desktop.
Requirements
- VS Code 1.80.0 or higher
- An OpenCode account, OpenRouter API key, or eligible Blue API key
- Internet connection
© 2026 Imergene. All rights reserved.
