SuperQode Setup¶

SuperQode is an AI coding agent platform with native ACP support. This guide shows how to use Amp with SuperQode.

Prerequisites¶

SuperQode installed

Amp CLI authenticated:

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

Quick Setup¶

Python Version¶

pip install acp-amp

Add to your SuperQode config:

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

Node.js Version¶

agents:
  amp:
    description: "Amp Code agent"
    protocol: acp
    command: npx
    args: ["@superagenticai/acp-amp"]

Or with global install:

npm install -g @superagenticai/acp-amp

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

Usage¶

Connect to Amp¶

superqode connect acp amp

Chat with Amp¶

superqode chat amp "Explain this codebase"

Run a task¶

superqode run amp "Refactor the authentication module"

Configuration Options¶

With API Key¶

agents:
  amp:
    description: "Amp Code agent"
    protocol: acp
    command: acp-amp
    args: ["run"]
    env:
      AMP_API_KEY: "your-api-key"

With Working Directory¶

agents:
  amp:
    description: "Amp Code agent"
    protocol: acp
    command: acp-amp
    args: ["run"]
    cwd: "/path/to/project"

Python Driver Options¶

agents:
  amp-python:
    description: "Amp with Python SDK"
    protocol: acp
    command: acp-amp
    args: ["run", "--driver", "python"]

  amp-node:
    description: "Amp with Node shim"
    protocol: acp
    command: acp-amp
    args: ["run", "--driver", "node"]

Troubleshooting¶

"Agent not found"¶

Make sure the agent is defined in your SuperQode config file.

"Connection failed"¶

Test the command manually:

acp-amp run
# or
npx @superagenticai/acp-amp

"Authentication error"¶

Login to Amp:

amp login