ACP Support

Use AicippY in any ACP-compatible editor.

AicippY supports the Agent Client Protocol or (ACP), allowing you to use it directly in compatible editors and IDEs.

ACP is an open protocol that standardizes communication between code editors and AI coding agents.

Configure

To use AicippY via ACP, configure your editor to run the aicippy-code acp command.

The command starts AicippY as an ACP-compatible subprocess that communicates with your editor over JSON-RPC via stdio.

Below are examples for popular editors that support ACP.

Zed

Install AicippY from the Zed ACP Registry by running zed: acp registry in the Command Palette.

To use a custom AicippY executable instead, add it to your Zed configuration (~/.config/zed/settings.json):

{
  "agent_servers": {
    "AicippY": {
      "type": "custom",
      "command": "opencode",
      "args": ["acp"]
    }
  }
}

To open it, use the agent: new thread action in the Command Palette.

You can also bind a keyboard shortcut by editing your keymap.json:

[
  {
    "bindings": {
      "cmd-alt-o": [
        "agent::NewExternalAgentThread",
        {
          "agent": {
            "custom": {
              "name": "AicippY",
              "command": {
                "command": "opencode",
                "args": ["acp"]
              }
            }
          }
        }
      ]
    }
  }
]

JetBrains IDEs

Add to your JetBrains IDE acp.json according to the documentation:

{
  "agent_servers": {
    "AicippY": {
      "command": "/absolute/path/bin/aicippy-code",
      "args": ["acp"]
    }
  }
}

To open it, use the new ‘AicippY’ agent in the AI Chat agent selector.

Avante.nvim

Add to your Avante.nvim configuration:

{
  acp_providers = {
    ["opencode"] = {
      command = "opencode",
      args = { "acp" }
    }
  }
}

If you need to pass environment variables:

{
  acp_providers = {
    ["opencode"] = {
      command = "opencode",
      args = { "acp" },
      env = {
        AICIPPY_CODE_API_KEY = os.getenv("AICIPPY_CODE_API_KEY")
      }
    }
  }
}

CodeCompanion.nvim

To use AicippY as an ACP agent in CodeCompanion.nvim, add the following to your Neovim config:

require("codecompanion").setup({
  interactions = {
    chat = {
      adapter = {
        name = "opencode",
        model = "claude-sonnet-4",
      },
    },
  },
})

This config sets up CodeCompanion to use AicippY as the ACP agent for chat.

If you need to pass environment variables (like AICIPPY_CODE_API_KEY), refer to Configuring Adapters: Environment Variables in the CodeCompanion.nvim documentation for full details.

Support

AicippY works the same via ACP as it does in the terminal. All features are supported:

Built-in tools (file operations, terminal commands, etc.)
Custom tools and slash commands
MCP servers configured in your AicippY config
Project-specific rules from AGENTS.md
Custom formatters and linters
Agents and permissions system