OpenACP provides a self-hosted bridge to connect over 28 AI coding agents, including Claude Code, Codex, Gemini, and Cursor, with popular messaging platforms like Telegram, Discord, and Slack. It empowers users to control AI coding agents directly from their preferred chat interfaces, offering real-time code generation, execution, and output visibility. This solution is ideal for developers and power users seeking to enhance remote development workflows, improve team visibility into AI-driven coding sessions, integrate AI into CI/CD pipelines, or leverage self-hosted AI models while maintaining full control over their data and API keys.

How It Works

OpenACP acts as a bridge, translating user interactions from messaging platforms into commands for AI coding agents via the Agent Client Protocol (ACP). The architecture flows from the user's messaging client (Telegram, Discord, Slack) to the OpenACP bridge and session manager, which then communicates with the selected AI agent. This approach allows users to interact with AI agents as if they were in a chat, with code, commands, and results streamed back in real-time. Its core advantage lies in enabling control from any device, supporting remote development, and offering a native messaging UI experience, eliminating the need for direct terminal or IDE access for many tasks.

Quick Start & Requirements

Installation is streamlined via cross-platform scripts for macOS, Linux (including WSL), and Windows. A Node.js version of 20 or higher is required. After installation, an interactive setup wizard guides users through configuring their preferred messaging platform (Telegram, Discord, Slack), connecting bot tokens, selecting a workspace directory, and choosing a default AI agent. Detailed setup guides and comprehensive documentation are available.

Highlighted Details

• Supports a wide array of 28+ AI agents, including popular options like Claude Code, Codex, Gemini, GitHub Copilot, and Cursor.
• Offers stable integration with Telegram, Discord, and Slack, featuring real-time streaming, permission buttons, and platform-specific session management (e.g., forum topics, threads).
• Enables remote development and CI/CD integration through a built-in REST API.
• Facilitates the use of local or self-hosted LLMs via ACP-compatible adapters for agents like Ollama and LM Studio.
• Includes advanced features such as session persistence, granular permission control, real-time usage tracking with budget limits, and tunnel/port forwarding capabilities.

Maintenance & Community

OpenACP is under active development, indicated by its "early stage" status and ongoing feature additions. Community engagement and support are facilitated through GitHub Discussions.

Licensing & Compatibility

The project is released under the permissive MIT License, allowing for broad use, modification, and distribution, including in commercial and closed-source applications.

Limitations & Caveats

As an early-stage project, users should anticipate potential breaking changes between minor versions. The current design primarily targets individual use, with multi-user support planned for future releases. Daemon mode, enabling auto-start on boot, is not yet supported on Windows. Furthermore, not all messaging platform-specific features are implemented with equal parity across all supported clients. Agents run on the same machine as OpenACP; for remote server execution, OpenACP must be installed directly on that server.