IDE Integration

This page covers practical setup for using the Python DeepAgents ACP server with IDEs and development tools.

CLI

Run the ACP server from the command line:

# Using the module directly
python -m deepagents_acp --root-dir /path/to/project

# Without --root-dir defaults to current working directory
python -m deepagents_acp

CLI Options

Option	Description
--root-dir <path>	Root directory accessible to the agent (default: cwd)

Environment Variables

Variable	Description
ANTHROPIC_API_KEY	API key for Anthropic/Claude models (required)
LANGSMITH_TRACING	Set to "true" to enable LangSmith tracing
LANGSMITH_API_KEY	API key for LangSmith
LANGSMITH_PROJECT	LangSmith project name

Zed

Using the Shell Script

The package includes a run.sh entrypoint for Zed integration. Add to your Zed settings:

{
  "agent_servers": {
    "DeepAgents": {
      "type": "custom",
      "command": "/absolute/path/to/deepagents/libs/acp/run.sh"
    }
  }
}

Make sure the script is executable:

chmod +x run.sh

Using uv

If you have uv installed, you can run the server directly:

{
  "agent": {
    "profiles": {
      "deepagents": {
        "name": "DeepAgents",
        "command": "uv",
        "args": ["run", "python", "-m", "deepagents_acp"],
        "env": {
          "ANTHROPIC_API_KEY": "sk-ant-..."
        }
      }
    }
  }
}

Getting Started

1. Install Zed and uv

2. Clone the repository:

git clone git@github.com:langchain-ai/deepagents.git
cd deepagents/libs/acp
uv sync

1. Create a .env file with your API key:

ANTHROPIC_API_KEY="your-key-here"

1. Add the agent to your Zed settings (see above)

2. Open Zed's Agents Panel (CMD + Shift + ?) and create a new DeepAgent thread

ACP Protocol Support

Implemented Agent Methods

Method	Description
initialize	Negotiate versions and capabilities
session/new	Create a new conversation session
session/set_mode	Switch between operating modes
session/prompt	Process user prompts
session/cancel	Cancel ongoing operations

Session Updates Sent

Update	Description
agent_message_chunk	Stream agent text responses
tool_call	Notify about tool invocations
tool_call_update	Update tool call status
plan	Send task plan entries

Advertised Capabilities

Capability	Description
promptCapabilities.image	Image content support