---
title: "Zed"
sidebarTitle: "Zed"
description: "Run Devin CLI inside the Zed editor as a custom ACP agent in the Agent Panel."
icon: "code"
keywords: ['Zed', 'ACP', 'Agent Client Protocol', 'Agent Panel', 'external agent', 'custom agent']
---

[Zed](https://zed.dev/) has native support for the
[Agent Client Protocol (ACP)](https://agentclientprotocol.com/), so you can run
Devin CLI as a custom external agent directly inside Zed's **Agent Panel** —
with real-time editing, syntax highlighting, and agent following.

<Note>
This integration uses Zed's built-in support for external ACP agents. For the
upstream reference, see the Zed docs on
[external agents](https://zed.dev/docs/ai/external-agents).
</Note>

## Setup

<Steps>
  <Step title="Install Devin">
    Open the ACP registry with `zed: acp registry` from the command palette (Cmd+Shift+P on macOS and Ctrl+Shift+P on Windows). Search for "Devin" and install it.

    <video autoPlay muted loop playsInline className="w-full aspect-video" src="/images/cli/acp/zed-install.mp4"></video>

  </Step>
  <Step title="Select Devin in the Threads Sidebar">
    On the top left corner of the Threads Sidebar, click on the agent dropdown menu and select "Devin".

    <video autoPlay muted loop playsInline className="w-full aspect-video" src="/images/cli/acp/zed-select.mp4"></video>

  </Step>

  <Step title="Authenticate">
    In the new Devin thread, open the agent menu in the top right corner and select "Authenticate" (or "Reauthenticate"). Then on the bottom of the thread panel, click on "API Key". A browser window will open, where you can log into your Devin Cloud account and authenticate. If you don't have an account you can sign up for free!
    
    <video autoPlay muted loop playsInline className="w-full aspect-video" src="/images/cli/acp/zed-auth.mp4"></video>
  </Step>

  <Step title="Build with Devin">
    You can now start a conversation with Devin! By default, Devin will use Adaptive model selection, automatically choosing the best model for your task. You can also pick a specific model from the menu at the bottom of the thread panel.

    <Frame title="Devin in Zed">
      <img src="/images/cli/acp/zed-models.png" alt="Devin in Zed" />
    </Frame>

  </Step>
</Steps>

## Notes and limitations

- Devin CLI's terminal/shell output is surfaced through Zed's ACP rendering,
  which differs from the native Devin CLI terminal UI. Some richer interactions
  are only available in the standalone CLI.
- The `devin acp` subcommand is intended to be launched by an ACP-aware client
  (like Zed) as a subprocess — it speaks JSON-RPC over stdio and is not meant to
  be run interactively. See
  [`devin acp`](/cli/reference/commands#devin-acp) in the command reference.
