Agent Client Protocol (ACP)

Use Mind in JetBrains IDEs, Zed, and other ACP-compatible editors by running Mind CLI as an Agent Client Protocol agent

Mind CLI implements the Agent Client Protocol (ACP), an open standard that enables AI agents to work with any compatible editor. This means you can use Mind's agentic capabilities in JetBrains IDEs, Zed, and other ACP-compatible editors.

What is ACP?

AI coding agents and editors are tightly coupled, but interoperability isn't the default. ACP solves this by providing a standardised protocol for agent-editor communication—similar to how LSP standardised language servers. Agents that implement ACP work with any compatible editor, and editors that support ACP gain access to all ACP-compatible agents.

Quick start

Run Mind as an ACP agent:

mind acp

To use a specific agent configuration:

mind acp --agent my-agent

Editor setup

Zed

Add to ~/.config/zed/settings.json:

{
  "agent_servers": {
    "Mind Agent": {
      "type": "custom",
      "command": "~/.local/bin/mind",
      "args": ["acp"],
      "env": {}
    }
  }
}

JetBrains IDEs

Add to ~/.jetbrains/acp.json:

{
  "agent_servers": {
    "Mind Agent": {
      "command": "/full/path/to/mind",
      "args": ["acp"]
    }
  }
}

Supported ACP methods

Method	Description
initialize	Initialize the connection and exchange capabilities
session/new	Create a new chat session
session/load	Load an existing session by ID
session/prompt	Send a prompt to the agent
session/cancel	Cancel the current operation
session/set_mode	Switch agent mode
session/set_model	Change the model for the session

Mind extensions

Mind extends ACP with custom methods (prefixed with _mindcode.sh/) to expose Mind-specific features like slash commands, MCP servers, and context compaction.

Session storage

ACP sessions are persisted to disk at ~/.mind/sessions/cli/.