acp-amp 0.1.3

ACP adapter that bridges Amp Code to Agent Client Protocol

acp-amp

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

---

🎯 Choose Your Version

If you prefer...	Install	Package
Python	pip install acp-amp	PyPI
Node.js	npm install -g @superagenticai/acp-amp	npm

Both versions provide identical functionality — full Amp Code agent capabilities in ACP-compatible clients.

---

🚀 Quick Start

For Python Developers

# Install (recommended)
uv tool install acp-amp

# Run
acp-amp run

For Node.js Developers

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

# Run
acp-amp

For Zed Users (Quickest Setup)

Add to your Zed settings (~/.config/zed/settings.json):

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

No installation needed — npx downloads and runs automatically!

---

📋 Prerequisites

Before using acp-amp, you need:

1. Amp CLI installed and authenticated:

   curl -fsSL https://ampcode.com/install.sh | bash
   amp login
   

2. Runtime (one of):

   • Python 3.10+ and uv (for Python version)
   • Node.js 18+ (for Node.js version)

---

🐍 Python Version (Detailed)

The Python version is ideal for Python developers and integrates with Python-based ACP clients.

Installation

# Recommended
uv tool install acp-amp

# Alternative: pip
pip install acp-amp

Running

# Default: uses Python SDK
acp-amp run

# Explicit Python SDK
acp-amp run --driver python

# Node shim fallback (if Python SDK has issues)
acp-amp run --driver node

# Auto-detect (tries Python first, falls back to Node)
acp-amp run --driver auto

Driver Comparison

Driver	Description	When to Use
python	Native Python SDK (amp-sdk)	Default, best performance
node	Node.js shim fallback	If Python SDK has issues
auto	Tries Python, falls back to Node	Maximum compatibility

Setting Up Node Shim (Fallback Only)

Only needed if you want to use --driver node:

# Create shim files
acp-amp setup

# Install shim dependencies
cd ~/.acp-amp/shim
npm install

Zed Configuration (Python)

{
  "agent_servers": {
    "Amp": {
      "command": "acp-amp",
      "args": ["run"]
    }
  }
}

With explicit driver:

{
  "agent_servers": {
    "Amp": {
      "command": "acp-amp",
      "args": ["run", "--driver", "python"]
    }
  }
}

---

📦 Node.js Version (Detailed)

The Node.js version is ideal for JavaScript/TypeScript developers and npm-based workflows.

Installation

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

# Or run directly with npx (no install)
npx @superagenticai/acp-amp

Running

# If installed globally
acp-amp

# Using npx (no install needed)
npx @superagenticai/acp-amp

Zed Configuration (Node.js)

With global install:

{
  "agent_servers": {
    "Amp": {
      "command": "acp-amp"
    }
  }
}

With npx (no install needed):

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

---

🔧 Zed Configuration (Complete Examples)

Minimal Setup

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

With API Key

{
  "agent_servers": {
    "Amp": {
      "command": "acp-amp",
      "args": [],
      "env": {
        "AMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Python with Specific Driver

{
  "agent_servers": {
    "Amp": {
      "command": "acp-amp",
      "args": ["run", "--driver", "python"],
      "env": {
        "AMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Full Path (if command not in PATH)

{
  "agent_servers": {
    "Amp": {
      "command": "/Users/yourname/.local/bin/acp-amp",
      "args": ["run"]
    }
  }
}

---

🔌 Other ACP Clients

SuperQode

agents:
  amp:
    description: "Amp Code agent"
    protocol: acp
    command: acp-amp
    args: []

superqode connect acp amp

Generic ACP Client

Any ACP client that can launch a subprocess and speak JSON-RPC over stdio:

# Python version
acp-amp run

# Node.js version
npx @superagenticai/acp-amp

Python ACP Clients

These Python-based ACP clients work great with acp-amp:

• Toad
• fast-agent
• SuperQode

---

✨ Features

• Full Amp Code capabilities — All Amp features available in your ACP client
• Multi-turn conversations — Thread continuity across interactions
• Tool execution — Run tools with permission modes (default/bypass)
• MCP server integration — Connect to Model Context Protocol servers
• Image support — Send and receive images
• Session management — Multiple concurrent sessions

---

🏗️ Project Structure

acp-amp/
├── acp_amp/              # Python package (pip install acp-amp)
│   ├── cli.py            # Command-line interface
│   ├── server.py         # ACP server implementation
│   └── driver/
│       ├── python_sdk.py # Python SDK driver (default)
│       └── node_sdk.py   # Node shim driver (fallback)
├── node/                 # Node.js package (@superagenticai/acp-amp)
│   └── src/
│       ├── index.js      # Entry point
│       ├── server.js     # ACP server implementation
│       └── to-acp.js     # Event conversion
├── node-shim/            # Minimal shim for Python's --driver node
└── docs/                 # Documentation

---

🧪 Development

Python Development

# Clone and install
git clone https://github.com/SuperagenticAI/acp-amp.git
cd acp-amp
pip install -e .[test]

# Run tests
pytest

# With uv
uv sync
uv run pytest

Node.js Development

cd node
npm install
npm start

Documentation

pip install -e .[docs]
mkdocs serve
# Visit http://localhost:8000

---

🐛 Troubleshooting

"amp: command not found"

Install the Amp CLI:

curl -fsSL https://ampcode.com/install.sh | bash
amp login

"SystemMessage object has no attribute 'get'" (Python)

Update to the latest version:

pip install --upgrade acp-amp

Python SDK issues

Use the Node shim fallback:

acp-amp run --driver node

Zed doesn't show the agent

1. Check your settings.json syntax
2. Restart Zed
3. Check Zed's output panel for errors

More help

See Troubleshooting Guide

---

📄 License

Apache-2.0

---

🙏 Credits

Brought to you by Superagentic AI

Built with:

• Amp Code by Sourcegraph
• Agent Client Protocol by Anthropic