Skip to main content
IDE integration via ACP is experimental and may have limitations. Please report any issues on the OpenHands-CLI repo.

​
What is the Agent Client Protocol (ACP)?

The Agent Client Protocol (ACP) is a standardized communication protocol that enables code editors and IDEs to interact with AI agents. ACP defines how clients (like code editors) and agents (like OpenHands) communicate through a JSON-RPC 2.0 interface.

​
Supported IDEs

IDESupport LevelSetup Guide
ZedNativeBuilt-in ACP support
ToadNativeUniversal terminal interface
VS CodeCommunity ExtensionVia VSCode ACP extension
JetBrainsNativeIntelliJ, PyCharm, WebStorm, etc.

​
Prerequisites

Before using OpenHands with any IDE, you must:
  1. Install OpenHands CLI following the installation instructions
  2. Configure your LLM settings using the /settings command: 
    openhands
# Then use /settings to configure
The ACP integration will reuse the credentials and configuration from your CLI settings stored in ~/.openhands/settings.json.

​
How It Works

  1. Your IDE launches openhands acp as a subprocess
  2. Communication happens via JSON-RPC 2.0 over stdio
  3. OpenHands uses your configured LLM and runtime settings
  4. Results are displayed in your IDE’s interface

​
The ACP Command

The openhands acp command starts OpenHands as an ACP server: 
# Basic ACP server
openhands acp

# With LLM-based approval
openhands acp --llm-approve

# Resume a conversation
openhands acp --resume <conversation-id>

# Resume the latest conversation
openhands acp --resume --last

​
ACP Options

OptionDescription
--resume [ID]Resume a conversation by ID
--lastResume the most recent conversation
--always-approveAuto-approve all actions
--llm-approveUse LLM-based security analyzer
--streamingEnable token-by-token streaming

​
Choosing an IDE

Zed

High-performance editor with native ACP support. Best for speed and simplicity.

Toad

Universal terminal interface. Works with any terminal, consistent experience.

VS Code

Popular editor with community extension. Great for VS Code users.

JetBrains

IntelliJ, PyCharm, WebStorm, etc. Best for JetBrains ecosystem users.

​
Resuming Conversations in IDEs

You can resume previous conversations in ACP mode. Since ACP mode doesn’t display an interactive list, first find your conversation ID: 
openhands --resume
This shows your recent conversations: 
Recent Conversations:
--------------------------------------------------------------------------------
 1. abc123def456 (2h ago)
    Fix the login bug in auth.py

 2. xyz789ghi012 (yesterday)
    Add unit tests for the user service
--------------------------------------------------------------------------------
Then configure your IDE to use --resume <id> or --resume --last. See each IDE’s documentation for specific configuration.

​
See Also