Metadata-Version: 2.4
Name: acp-amp
Version: 0.1.1
Summary: ACP adapter that bridges Amp Code to Agent Client Protocol
Author-email: Shashi Jagtap <info@super-agentic.ai>
Maintainer-email: Shashi Jagtap <info@super-agentic.ai>
License: MIT
Project-URL: Homepage, https://github.com/SuperagenticAI/acp-amp
Project-URL: Repository, https://github.com/SuperagenticAI/acp-amp
Project-URL: Issues, https://github.com/SuperagenticAI/acp-amp/issues
Project-URL: Documentation, https://github.com/SuperagenticAI/acp-amp
Keywords: acp,agent-client-protocol,amp,adapter,zed,superqode
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: agent-client-protocol>=0.7.1
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5; extra == "docs"
Requires-Dist: mkdocs-material>=9.5; extra == "docs"
Dynamic: license-file

# acp-amp

![CI](https://github.com/SuperagenticAI/acp-amp/actions/workflows/ci.yml/badge.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)

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)

```bash
uv tool install acp-amp
```

## Install (pip)

```bash
pip install acp-amp
```

## Install (dev)

```bash
pip install -e .
```

## Install with uv

```bash
uv sync
```

## Install Node shim deps

```bash
cd node-shim
npm install
```

## Run

```bash
acp-amp
```

## Tests

```bash
pip install -e .[test]
pytest
```

## Tests with uv

```bash
uv run pytest
```

## Docs

```bash
pip install -e .[docs]
mkdocs serve
```

## Docs with uv

```bash
uv run mkdocs serve
```

## Use from an ACP client (example: SuperQode)

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

Then connect:

```bash
superqode connect acp amp
```

## Zed example

```json
{
  "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
