Skip to content
AgentZero

VS Code

Overview

Section titled “Overview”

VS Code integrates with AgentZero via ACP (full agent) or MCP (tool-only via extensions like Cline or Continue).

Recommended: ACP — AgentZero runs the full agentic loop using your local models.

Section titled “ACP Setup (Recommended)”

1. Generate config

Section titled “1. Generate config”
Terminal window
az init --editor vscode

This creates .vscode/tasks.json with two tasks:

  • AgentZero Serve — starts the ACP server
  • AgentZero Chat — single-query mode with input prompt

2. Run the task

Section titled “2. Run the task”

Press Ctrl+Shift+P > “Tasks: Run Task” > “AgentZero Serve”.

This starts az serve in a VS Code terminal panel, communicating over stdio.

3. Interactive chat

Section titled “3. Interactive chat”

For interactive sessions, open a VS Code terminal and run:

Terminal window
az chat

MCP Setup (Tool-Only)

Section titled “MCP Setup (Tool-Only)”

Use MCP with extensions like Cline or Continue that support MCP servers.

Add AgentZero as an MCP server in your extension’s configuration:

{
  "mcpServers": {
    "agentzero": {
      "command": "az",
      "args": ["mcp"]
    }
  }
}

Security

Section titled “Security”
  • Stdio-only transport — no network ports opened
  • Policy enforcement — all tool calls go through the policy engine
  • Audit trail — every action logged to .agentzero/audit/

Troubleshooting

Section titled “Troubleshooting”
  • Task not found — run az init --editor vscode to generate .vscode/tasks.json
  • Provider errors — run az doctor to check connectivity