feat: ACP bridge for editor integration by khaliqgant · Pull Request #333 · AgentWorkforce/relay

khaliqgant · 2026-01-28T11:21:22Z

Summary

Adds @agent-relay/acp-bridge package that exposes relay agents to ACP-compatible editors (Zed, Neovim, etc.)
Implements the Agent Client Protocol (JSON-RPC 2.0 over stdio) to bridge editor prompts to all connected relay agents
Adds comprehensive documentation for editor integration

Changes

New package: packages/acp-bridge/ with relay client, ACP agent implementation, and CLI
Documentation: docs/guides/editor-integration.mdx with setup instructions for Zed, Neovim, and other editors
Navigation: Updated docs/mint.json to include the new guide

How it works

┌─────────────────┐     ACP (stdio)    ┌─────────────────┐
│   Zed Editor    │ ◄────────────────► │  relay-acp      │
│   (or other)    │   JSON-RPC 2.0     │  (bridge)       │
└─────────────────┘                    └────────┬────────┘
                                                │
                                       Relay Protocol
                                                │
                                       ┌────────▼────────┐
                                       │  Relay Daemon   │
                                       └────────┬────────┘
                                                │
                        ┌───────────────────────┼───────────────────────┐
                        │                       │                       │
                   Agent 1                 Agent 2                 Agent N

Test plan

Build the acp-bridge package
Configure Zed to use relay-acp as a custom agent
Verify prompts are broadcast to connected relay agents
Verify responses stream back to the editor

🤖 Generated with Claude Code

…itors Implements an ACP (Agent Client Protocol) bridge that allows ACP-compatible editors like Zed to communicate with Agent Relay agents. Key features: - ACP JSON-RPC server over stdio transport - Session management (new sessions, cancellation) - Prompt handling with streaming responses - Relay daemon client for agent communication - CLI entry point (relay-acp) The bridge broadcasts user prompts to all connected relay agents and streams their responses back to the editor in real-time. Usage: relay-acp --name my-agent --debug Or configure in Zed settings: { "agent": { "custom_agents": [{ "name": "Agent Relay", "command": "relay-acp" }] } } 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Documents how to use the ACP bridge to integrate Agent Relay with code editors like Zed and Neovim that support the Agent Client Protocol. Covers: - Architecture overview and message flow - Installation and configuration for various editors - CLI options and environment variables - Programmatic usage with TypeScript - Troubleshooting and best practices 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

devin-ai-integration

Devin Review found 1 potential issue.

View issue and 5 additional flags in Devin Review.

…itors Implements an ACP (Agent Client Protocol) bridge that allows ACP-compatible editors like Zed to communicate with Agent Relay agents. Key features: - ACP JSON-RPC server over stdio transport - Session management (new sessions, cancellation) - Prompt handling with streaming responses - Relay daemon client for agent communication - CLI entry point (relay-acp) The bridge broadcasts user prompts to all connected relay agents and streams their responses back to the editor in real-time. Usage: relay-acp --name my-agent --debug Or configure in Zed settings: { "agent": { "custom_agents": [{ "name": "Agent Relay", "command": "relay-acp" }] } } 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Documents how to use the ACP bridge to integrate Agent Relay with code editors like Zed and Neovim that support the Agent Client Protocol. Covers: - Architecture overview and message flow - Installation and configuration for various editors - CLI options and environment variables - Programmatic usage with TypeScript - Troubleshooting and best practices 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

devin-ai-integration

Devin Review found 1 new potential issue.

View issue and 9 additional flags in Devin Review.

devin-ai-integration

Devin Review found 1 new potential issue.

View issue and 10 additional flags in Devin Review.

…/acp-bridge

Add 'zed-bridge' to the INTERNAL_AGENTS set so it doesn't appear in the default `agent-relay agents` output. It will still be visible when using the --all flag. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

devin-ai-integration

Devin Review found 1 new potential issue.

View issue and 12 additional flags in Devin Review.

- Add @AgentName targeting to send messages to specific agents - Use main @agent-relay/sdk instead of duplicate relay-client - Restructure docs to emphasize `agent-relay up --zed` quick start - Move advanced editor config (Neovim, programmatic usage) to bottom - Remove redundant CLI Options section from docs 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

…nced Streamline the editor integration guide by removing unnecessary internal details and moving programmatic usage to the advanced section. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Add vscode-acp extension to editor integration docs. Note that it currently only supports auto-detected agents (Claude, OpenCode, etc.) and doesn't yet have custom agent configuration support. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

When an agent crashes (SIGKILL, OOM, etc.), the ACP bridge now: - Detects system messages via isSystemMessage flag - Formats crash notifications with agent name, signal, exit code - Broadcasts to all active Zed sessions (not just processing ones) This ensures users see when spawned agents die unexpectedly. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Add `agent-relay status` command to show: - Connection state (Connected/Disconnected) - Relay client state - Agent name - Number of connected agents 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Add `agent-relay uninstall` command with options: - --keep-data: Keep database and message history, only remove runtime files - --zed: Also remove Agent Relay from Zed editor configuration - --snippets: Remove agent-relay snippets from CLAUDE.md, GEMINI.md, AGENTS.md - --force: Skip confirmation prompt - --dry-run: Preview what would be removed without making changes The command stops the daemon if running, then removes the .agent-relay/ directory and optionally cleans up related configuration. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

+            content = content.replace(/<!-- prpm:snippet:start @agent-relay\/agent-relay-protocol.*?<!-- prpm:snippet:end @agent-relay\/agent-relay-protocol[^\n]*\n?/gs, '');
+
+            if (content.length !== originalLength) {
+              fs.writeFileSync(filePath, content);


🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Regenerated lock file from scratch to ensure all workspace packages are properly recorded for npm ci. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

devin-ai-integration

Devin Review found 1 new potential issue.

View issue and 18 additional flags in Devin Review.

Add @agent-relay/acp-bridge to the packages matrix in publish.yml so it gets published alongside other workspace packages. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

… IDE - Add onChannelMessage handler to receive channel broadcasts - Subscribe to #general channel on connect - Route channel messages to all active sessions in Zed This ensures messages sent to #general by agents are visible in the IDE. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

…cp-bridge

khaliqgant and others added 2 commits January 28, 2026 12:14

mintlify Bot deployed to staging - docs January 28, 2026 11:21 View deployment

devin-ai-integration Bot reviewed Jan 28, 2026

View reviewed changes

Comment thread packages/acp-bridge/src/acp-agent.ts

khaliqgant and others added 2 commits January 30, 2026 20:46

khaliqgant force-pushed the feature/acp-bridge branch from e69cf09 to 8ce2879 Compare January 30, 2026 20:47

mintlify Bot deployed to staging - docs January 30, 2026 20:48 View deployment

devin-ai-integration Bot reviewed Jan 30, 2026

View reviewed changes

Comment thread packages/acp-bridge/src/acp-agent.ts

fix: regenerate package-lock.json for Node 24 npm compatibility

53b042a

devin-ai-integration Bot reviewed Jan 31, 2026

View reviewed changes

Comment thread packages/acp-bridge/src/relay-client.ts Outdated

khaliqgant and others added 3 commits February 3, 2026 15:32

Merge remote-tracking branch 'origin/feature/acp-bridge' into feature…

ff24329

…/acp-bridge

Merge origin/feature/acp-bridge - keep both integration guides

33f71f1

mintlify Bot deployed to staging - docs February 3, 2026 19:22 View deployment

devin-ai-integration Bot reviewed Feb 3, 2026

View reviewed changes

Comment thread src/cli/index.ts

mintlify Bot deployed to staging - docs February 3, 2026 19:34 View deployment

mintlify Bot deployed to staging - docs February 3, 2026 19:36 View deployment

mintlify Bot deployed to staging - docs February 3, 2026 19:38 View deployment

khaliqgant and others added 5 commits February 3, 2026 20:44

socket fix

24057f5

chore: sync package-lock.json with workspace packages

bb3b352

🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

github-advanced-security AI found potential problems Feb 3, 2026

View reviewed changes

khaliqgant and others added 2 commits February 3, 2026 21:11

chore: sync package-lock.json

7f290d9

🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

fix lock

e13e55b

chore: regenerate package-lock.json for CI compatibility

d9fc25a

Regenerated lock file from scratch to ensure all workspace packages are properly recorded for npm ci. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

devin-ai-integration Bot reviewed Feb 3, 2026

View reviewed changes

Comment thread src/cli/index.ts Outdated

khaliqgant and others added 7 commits February 3, 2026 22:37

revert: restore package-lock.json from main

e904034

🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Merge branch 'main' of github.com:AgentWorkforce/relay into feature/a…

b055c84

…cp-bridge

bump version

c25bd42

dep update

9eb2538

review

dca1deb

khaliqgant merged commit d708bca into main Feb 3, 2026
31 of 32 checks passed

khaliqgant deleted the feature/acp-bridge branch February 3, 2026 22:08

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: ACP bridge for editor integration#333

feat: ACP bridge for editor integration#333
khaliqgant merged 26 commits into
mainfrom
feature/acp-bridge

khaliqgant commented Jan 28, 2026 •

edited by devin-ai-integration Bot

Loading

Uh oh!

devin-ai-integration Bot left a comment

Uh oh!

Uh oh!

devin-ai-integration Bot left a comment

Uh oh!

Uh oh!

devin-ai-integration Bot left a comment

Uh oh!

Uh oh!

devin-ai-integration Bot left a comment

Uh oh!

Uh oh!

Check failure

devin-ai-integration Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

khaliqgant commented Jan 28, 2026 • edited by devin-ai-integration Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

How it works

Test plan

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Check failure

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

khaliqgant commented Jan 28, 2026 •

edited by devin-ai-integration Bot

Loading