acp-amp 0.1.0

ACP adapter that bridges Amp Code to Agent Client Protocol

acp-amp

acp-amp is an open source ACP adapter for Amp Code. It runs as a standard ACP agent over stdin and stdout and can be used from any ACP client, for example Zed or SuperQode.

Where you can use it

• Zed editor via agent_servers
• SuperQode via ACP agent config
• Any ACP client that can launch a subprocess and speak JSON-RPC over stdio

Install (recommended)

uv tool install acp-amp

Install (pip)

pip install acp-amp

Install (dev)

pip install -e .

Install with uv

uv sync

Install Node shim deps

cd node-shim
npm install

Run

acp-amp

Tests

pip install -e .[test]
pytest

Tests with uv

uv run pytest

Docs

pip install -e .[docs]
mkdocs serve

Docs with uv

uv run mkdocs serve

Use from an ACP client (example: SuperQode)

agents:
  amp:
    description: "Amp ACP adapter"
    protocol: acp
    command: acp-amp
    args: []

Then connect:

superqode connect acp amp

Zed example

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

Notes

• Stdout is reserved for ACP JSON-RPC messages, logs go to stderr
• The Node shim lives in node-shim/ and is launched automatically