Installation

    This guide covers detailed installation options for Chrome ACP.

    Installing the Proxy Server

    npm install -g @chrome-acp/proxy-server

    Using Bun

    bun install -g @chrome-acp/proxy-server

    Using pnpm

    pnpm install -g @chrome-acp/proxy-server

    Installing an ACP Agent

    You need an ACP-compatible agent to use Chrome ACP. Here are installation instructions for popular agents:

    Claude Code

    npm install -g @anthropic-ai/claude-code @zed-industries/claude-code-acp

    Codex CLI (OpenAI)

    npm install -g @openai/codex @zed-industries/codex-acp

    OpenCode

    curl -fsSL https://opencode.ai/install | bash

    Gemini CLI

    npm install -g @google/gemini-cli

    Qwen Code

    npm install -g @qwen-code/qwen-code@latest

    Augment Code

    npm install -g @augmentcode/auggie

    Installing the Chrome Extension

    The Chrome extension enables browser tools (reading tabs, executing scripts).

    1. Download chrome-extension.zip from Releases
    2. Unzip the file
    3. Open chrome://extensions in Chrome
    4. Enable Developer mode (toggle in top right)
    5. Click Load unpacked
    6. Select the unzipped folder

    Building from Source

    # Clone the repository
git clone https://github.com/Areo-Joe/chrome-acp.git
cd chrome-acp

# Install dependencies
bun install

# Build the extension
bun run build:extension

# Load packages/chrome-extension/dist in Chrome

    Verifying Installation

    Run the proxy server to verify everything is installed correctly:

    acp-proxy --help

    You should see the available CLI options.

    Next Steps