Skip to content

acp-amp Documentation

ACP adapter for Amp Code — Use Amp in any Agent Client Protocol (ACP) compatible client like Zed.

What is acp-amp?

acp-amp bridges Amp Code to the Agent Client Protocol (ACP), allowing you to use Amp's powerful AI coding capabilities in any ACP-compatible client.

Important: ACP requires a paid Amp credit balance. The free credit version does not work for ACP. Top up a few dollars in Amp to enable ACP access.

Available in two versions:

Version Install Best For
Python pip install acp-amp Python developers, uv/pip users
Node.js npm install -g @superagenticai/acp-amp JavaScript developers, npm users

Both versions provide identical functionality.

Quick Start

uv tool install acp-amp
acp-amp run

npm install -g @superagenticai/acp-amp
acp-amp

Add to ~/.config/zed/settings.json: 

{
  "agent_servers": {
    "Amp": {
      "command": "npx",
      "args": ["@superagenticai/acp-amp"]
    }
  }
}

Where You Can Use It

Editors

  • Zed — Modern code editor with native ACP support

ACP Clients

  • SuperQode — AI coding agent platform
  • Toad — Python ACP client
  • fast-agent — Fast Python ACP client
  • Any client that speaks JSON-RPC over stdio

acp-amp works with any ACP-compatible client. See the official ACP ecosystem list on the Zed ACP page and the ACP Registry announcement.

Agents on ACP (from the ecosystem list): - Gemini CLI (ACP Registry) - Claude Code (ACP Registry, via adapter) - Codex (ACP Registry, via adapter) - GitHub Copilot (ACP Registry) - JetBrains Junie (In Progress) - Goose - Kimi CLI - OpenCode (ACP Registry) - Stakpak - VT Code - Auggie CLI (ACP Registry) - Code Assistant - cagent - fast-agent - LLMling-Agent

Features

Feature Description
Full Amp capabilities All Amp Code features in your ACP client
Multi-turn conversations Thread continuity across interactions
Tool execution Permission modes: default or bypass
MCP integration Connect to Model Context Protocol servers
Image support Send and receive images
Session management Multiple concurrent sessions

Documentation

Architecture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   ACP Client    │────▶│    acp-amp      │────▶│    Amp Code     │
│  (Zed, etc.)    │◀────│  (Python/Node)  │◀────│    (Cloud)      │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │                       │
        │    JSON-RPC/stdio     │     Amp SDK          │
        │◀─────────────────────▶│◀─────────────────────▶│

Credits

Brought to you by Superagentic AI

Built with: