acp-setup.md

ACP Setup

Albert Code can be used in text editors and IDEs that support Agent Client Protocol. Albert Code includes the albert-acp tool. Once you have set up albert-code with the API keys, you are ready to use albert-acp in your editor. Below are the setup instructions for some editors that support ACP.

Zed

For usage in Zed, we recommend using the Albert Code Zed's extension. Alternatively, you can set up a local install as follows:

1. Go to ~/.config/zed/settings.json and, under the agent_servers JSON object, add the following key-value pair to invoke the albert-acp command. Here is the snippet:

{
   "agent_servers": {
      "Albert Code": {
         "type": "custom",
         "command": "albert-acp",
         "args": [],
         "env": {}
      }
   }
}

1. In the New Thread pane on the right, select the Albert Code agent and start the conversation.

JetBrains IDEs

For using Albert Code in JetBrains IDEs, you'll need to have the Jetbrains AI Assistant extension installed

Version 2025.3 or later

1. Open settings, then go to Tools > AI Assistant > Agents. Search for Albert Code, click install

2. Open AI Assistant. You should be able to select Albert Code from the agent selector (if you're not authenticated yet, you will be prompted to do so).

Legacy method

1. Add the following snippet to your JetBrains IDE acp.json (documentation):

{
  "agent_servers": {
    "Albert Code": {
      "command": "albert-acp",
    }
  }
}

1. In the AI Chat agent selector, select the new Albert Code agent and start the conversation.

Neovim (using avante.nvim)

Add Albert Code in the acp_providers section of your configuration

{
  acp_providers = {
    ["albert-code"] = {
      command = "albert-acp",
      env = {
         MISTRAL_API_KEY = os.getenv("MISTRAL_API_KEY"), -- necessary if you setup Albert Code manually
      },
    }
  }
}