docs/usage/acp.mdx
Cline CLI speaks the Agent Client Protocol (ACP), an open standard that lets editors and other tools drive terminal-based coding agents. Any ACP-capable client can use Cline as its coding agent without a dedicated extension — the same agent you use in the terminal, embedded in the tool you're already working in.
npm i -g cline)cline auth are reused automaticallyACP mode is started with the --acp flag:
cline --acp
You don't run this yourself — the client launches the command and talks to Cline over stdio. Configure the client to run it, then start a thread from its agent UI.
<Tip> If a client can't spawn the agent, it may not inherit your shell's `PATH`. Use the absolute path from `which cline` as the command. </Tip>ACP is supported by a growing ecosystem of editors, IDEs, and other tools. Setup for the most popular clients is below; the ACP client directory maintains the full list.
Add Cline as a custom agent in Zed's settings.json:
{
"agent_servers": {
"Cline": {
"type": "custom",
"command": "cline",
"args": ["--acp"],
"env": {}
}
}
}
Open the Agent Panel, start a new thread, and select Cline.
AI Assistant in JetBrains IDEs (IntelliJ IDEA, PyCharm, WebStorm, and others) supports ACP agents. In the AI Chat tool window, select Add Custom Agent — this creates ~/.jetbrains/acp.json — then add Cline:
{
"agent_servers": {
"Cline": {
"command": "cline",
"args": ["--acp"],
"env": {}
}
}
}
Cline then appears in the AI Chat agent selector.
The CodeCompanion plugin ships a built-in cline_cli ACP adapter that runs cline --acp. Set it as your chat adapter:
require("codecompanion").setup({
strategies = {
chat = { adapter = "cline_cli" },
},
})
Other Neovim ACP clients, such as avante.nvim and agentic.nvim, can also launch Cline via cline --acp.
agent-shell drives ACP agents from a native Emacs buffer. Configure a custom agent that runs cline --acp per the agent-shell docs.
Anything that speaks ACP can run Cline the same way — point it at cline --acp. The client directory includes note-taking apps like Obsidian, notebooks like marimo, mobile clients, and chat bridges for Slack, Discord, and Telegram.
cline auth are reused automatically.Set these under env in the client's agent server config to preconfigure the agent:
| Variable | Effect |
|---|---|
CLINE_API_KEY | Authenticate with an API key instead of interactive sign-in |
CLINE_PROVIDER | Pin the provider (disables provider switching in the client) |
CLINE_MODEL | Default model for new sessions |