acp-setup.md

ACP Setup

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

Zed

For usage in Zed, we recommend using the Mistral Vibe Zed ACP agent. 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 vibe-acp command. Here is the snippet:

{
   "agent_servers": {
      "Mistral Vibe": {
         "type": "custom",
         "command": "vibe-acp",
         "args": [],
         "env": {}
      }
   }
}

2. In the Agent Panel view, select the Mistral Vibe agent and start the conversation.

JetBrains IDEs

For using Mistral Vibe 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 Mistral Vibe, click install

2. Open AI Assistant. You should be able to select Mistral Vibe 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": {
    "Mistral Vibe": {
      "command": "vibe-acp",
    }
  }
}

1. In the AI Chat agent selector, select the new Mistral Vibe agent and start the conversation.

Neovim (using avante.nvim)

Add Mistral Vibe in the acp_providers section of your configuration

{
  acp_providers = {
    ["mistral-vibe"] = {
      command = "vibe-acp",
      env = {
         MISTRAL_API_KEY = os.getenv("MISTRAL_API_KEY"), -- necessary if you setup Mistral Vibe manually
      },
    }
  }
}