Name: 'Blue AI Coding Assistant'
Author: 'om-mali'

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.
Paste your OpenCode API key under configuration.
Start chatting with Blue!

Supported Models (All Free)

MiMo V2.5 Free: Best for complex reasoning and architecture decisions.
DeepSeek V4 Flash Free: Best for fast, general coding and surgical edits.
Nemotron 3 Ultra Free: Best for large context tasks and cross-file refactoring.
North Mini Code Free: Best for quick context lookups and inline actions.