Skip to main content

ACP Agents

ACP stands for Agent Client Protocol. It's an open standard for AI agents that lets Coeus talk to different agents using the same interface.

If you're not sure what this is, skip it for now. The Claude Code, Anthropic API, or OpenAI-compatible provider will cover most use cases.

What ACP gives you​

ACP agents can be installed from a registry or configured manually. Once connected, they work like any other provider in Coeus: you select them from the provider dropdown and they answer your questions, read your notes, and can write back to them.

Installing from the registry​

Coeus pulls a list of available ACP agents from the ACP registry.

  1. Open Settings → AI Providers → ACP
  2. Click Browse Registry
  3. Find the agent you want and click Install
  4. Coeus downloads and configures it automatically

Available agents include Claude in ACP mode and Kimi Coding via ACP.

Manual ACP setup​

If you have an ACP-compatible agent that isn't in the registry:

  1. Open Settings → AI Providers → ACP
  2. Choose Manual configuration
  3. Enter the command to start the agent (e.g. npx my-agent-server) and any required environment variables

Authentication​

Different ACP agents authenticate differently:

  • API key: You paste a key into the config
  • Environment variable: You set an env var in the configuration field
  • Terminal auth: A terminal window opens inside Coeus and you log in interactively (used for agents like Claude Code and Kimi)

Coeus stores credentials securely in your operating system's keychain.

File access​

ACP agents run with access to your notes folder. They can read and write files there. They can't access anything outside of it.