VSCode ACP Chat
AI coding agents in VS Code via the Agent Client Protocol (ACP)
This project is based on vscode-acp.
Chat with Claude, OpenCode, and other ACP-compatible AI agents directly in your editor. No context switching, no copy-pasting code.
Features
- Multi-Agent Support — Connect to OpenCode, Claude Code, Codex CLI, Gemini CLI, Goose, and other ACP-compatible agents
- Native Chat Interface — Integrated sidebar chat that feels like part of VS Code
- Tool Visibility — See what commands the AI runs with expandable input/output and file diffs
- Rich Markdown — Code blocks, syntax highlighting, and formatted responses
- Streaming Responses — Watch the AI think in real-time with thought chunks display
- Mode & Model Selection — Switch between agent modes and models on the fly
- Session History — Load and resume previous conversations
- Terminal Integration — View terminal output with ANSI color support
- File Change Tracking — Review and rollback file modifications made by AI
Requirements
You need at least one ACP-compatible agent installed:
Installation
From VS Code Marketplace
- Open VS Code
- Go to Extensions (
Cmd+Shift+X / Ctrl+Shift+X)
- Search for "VSCode ACP Chat"
- Click Install
From VSIX
- Download the
.vsix file from Releases
- In VS Code:
Extensions → ... → Install from VSIX...
Usage
- Click the ACP icon in the Activity Bar (left sidebar)
- Click Connect to start a session
- Select your preferred agent from the dropdown
- Start chatting!
When the AI uses tools (like running commands or reading files), you'll see them in a collapsible section:
- ⋯ — Tool is running
- ✓ — Tool completed successfully
- ✗ — Tool failed
Click on any tool to see the command input and output.
Configuration
The extension auto-detects installed agents. Supported agents:
| Agent |
Command |
Detection |
| OpenCode |
opencode acp |
Checks $PATH |
| Claude Code |
npx @zed-industries/claude-code-acp |
Checks $PATH |
| Codex CLI |
npx @zed-industries/codex-acp |
Checks $PATH |
| Gemini CLI |
gemini --acp |
Checks $PATH |
| Goose |
goose acp |
Checks $PATH |
| Amp |
amp acp |
Checks $PATH |
| Aider |
aider --acp |
Checks $PATH |
| Augment Code |
augment acp |
Checks $PATH |
| Kimi CLI |
kimi --acp |
Checks $PATH |
| Mistral Vibe |
vibe acp |
Checks $PATH |
| OpenHands |
openhands acp |
Checks $PATH |
| Qwen Code |
qwen --acp |
Checks $PATH |
| Kiro CLI |
kiro-cli acp |
Checks $PATH |
Development
# Install dependencies
npm install
# Compile
npm run compile
# Run in VS Code
# Press F5 to open Extension Development Host
License
MIT License - see LICENSE file for details.
This project is based on vscode-acp, maintaining the MIT open source license.
