Skip to content

README.md

Latest commit

 

History

History
102 lines (67 loc) · 3.23 KB

README.md

File metadata and controls

102 lines (67 loc) · 3.23 KB

VSCode ACP

AI coding agents in VS Code via the Agent Client Protocol (ACP)

VS Code Marketplace Open VSX License: MIT

Chat with Claude, OpenCode, and other ACP-compatible AI agents directly in your editor. No context switching, no copy-pasting code.

VSCode ACP Screenshot

Features

  • 🤖 Multi-Agent Support — Connect to OpenCode, Claude Code, or any ACP-compatible agent
  • 💬 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
  • 📝 Rich Markdown — Code blocks, syntax highlighting, and formatted responses
  • 🔄 Streaming Responses — Watch the AI think in real-time
  • 🎛️ Mode & Model Selection — Switch between agent modes and models on the fly

Requirements

You need at least one ACP-compatible agent installed:

Installation

From VS Code Marketplace

  1. Open VS Code
  2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
  3. Search for "VSCode ACP"
  4. Click Install

From VSIX

  1. Download the .vsix file from Releases
  2. In VS Code: Extensions → ... → Install from VSIX...

Usage

  1. Click the VSCode ACP icon in the Activity Bar (left sidebar)
  2. Click Connect to start a session
  3. Select your preferred agent from the dropdown
  4. Start chatting!

Tool Calls

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 Checks $PATH
Claude Code claude Checks $PATH

Development

# Clone the repo
git clone https://github.com/omercnet/vscode-acp.git
cd vscode-acp

# Install dependencies
npm install

# Compile
npm run compile

# Run in VS Code
# Press F5 to open Extension Development Host

Contributing

Contributions are welcome! Please read our Contributing Guide first.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

MIT © Omer Cohen

Report a Bug · Request a Feature