Building an ACP-Compatible Agent Live — Bennet Fenner, Zed

한 줄 핵심

Zed는 ACP(Agent Client Protocol)를 통해 서로 다른 코딩 에이전트를 하나의 편집기에서 표준 인터페이스로 연결하는 방법을 라이브 코딩으로 보여주며, 세션·스트리밍·툴 호출·파일 시스템·터미널까지 단계적으로 붙여 실제 동작하는 에이전트를 만든다.

시간별 요약

1. 0:14
   핵심 목표는 Claude code, Codex, Gemini CLI처럼 각기 다른 에이전트를 Zed에서 동일한 경험으로 쓰게 만드는 것이다. 이를 위해 ACP라는 JSON-RPC 기반 프로토콜을 도입해 에이전트와 클라이언트가 표준 인터페이스로 통신하도록 설계한다.
2. 2:01
   기본 코딩 에이전트는 파일 읽기와 기존 파일 수정이라는 두 가지 도구만 가진 매우 단순한 구조다. 모델 API는 상태를 저장하지 않으므로, 대화 이력과 툴 호출 결과를 다시 붙여 보내는 에이전트 루프가 동작의 중심이 된다.
3. 4:00
   ACP 호환을 위해서는 initialize, session 생성, prompt 처리, cancellation 같은 최소 인터페이스를 구현하면 된다. 세션마다 ID를 만들고 작업 디렉터리를 묶어 관리하면, 클라이언트는 같은 대화 흐름 안에서 에이전트를 안정적으로 호출할 수 있다.
4. 8:00
   모델의 스트리밍 출력은 session update로 클라이언트에 전달해야 UI에서 토큰 단위로 보인다. 파일 읽기 같은 툴도 시작 시점에는 in progress 상태를, 종료 시점에는 결과와 완료 상태를 따로 보내야 편집기 안에서 작업 진행이 자연스럽게 표현된다.
5. 12:00
   파일 시스템을 로컬 fs.readFile로 직접 읽는 대신 ACP가 제공하는 파일 시스템 capability를 통해 프록시하면, 버퍼의 미저장 변경분까지 에이전트가 볼 수 있다. 이후에는 터미널 capability까지 추가해 에이전트가 스스로 명령을 실행하는 수준으로 확장한다.

실무 인사이트

• 에이전트 연동은 모델 자체보다 세션, 스트리밍, 툴 상태, 파일·터미널 권한을 표준화하는 하네스 설계가 성패를 좌우한다.
• 편집기 내 에이전트 경험을 좋게 하려면 최종 결과보다 중간 진행 상태를 세밀하게 노출해야 하며, 특히 tool call의 in progress/complete 이벤트 분리가 중요하다.
• 로컬 파일 시스템을 직접 다루기보다 클라이언트 capability를 통해 프록시하면 미저장 버퍼까지 일관되게 반영할 수 있어 실제 개발 환경과 더 잘 맞는다.