by Open-ACP
Self-hosted bridge that lets you interact with AI coding agents (Claude Code, Codex, etc.) from messaging platforms (Telegram, Discord, etc.) via the Agent Client Protocol (ACP).
# Add to your Claude Code skills
git clone https://github.com/Open-ACP/OpenACPLast scanned: 5/23/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-23T06:35:32.785Z",
"semgrepRan": false,
"npmAuditRan": false,
"pipAuditRan": true
}No comments yet. Be the first to share your thoughts!
30 days in the Featured rail
OpenACP — self-hosted bridge that connects 28+ AI coding agents (Claude Code, Codex, Gemini, Cursor) to Telegram, Discord & Slack. Your machine, your keys, your data.
Control AI coding agents from Telegram, Discord & Slack
Send a message. The agent writes code. You see everything — in real time.
Documentation · Quick Start · Features · Agents · Contributing · Discussions
OpenACP is a self-hosted bridge that connects AI coding agents to your messaging platforms. You chat with an AI agent through Telegram, Discord, or Slack — it reads your codebase, writes code, runs commands, and streams results back to you in real time.
Built on the open Agent Client Protocol (ACP). Your machine, your keys, your data.
You (Telegram / Discord / Slack)
↓
OpenACP (bridge + session manager)
↓
AI Agent (Claude Code, Codex, Gemini, Cursor, ...)
↓
Your Codebase
| Without OpenACP | With OpenACP | |----------------|-------------| | "Its usage is currently focused on its dedicated terminal REPL and specific IDE integrations" | Control from Telegram, Discord, or Slack — any device, anywhere | | "Codex Desktop App only works with local projects. It does not support development on remote hosts" | Full remote development support — run agents on your server, manage from your phone | | "There's no way to trigger Claude Code sessions from external issue trackers" | REST API for CI/CD integration and external triggers | | "Being able to use a proper mobile app UI would be much better than having to access sessions through ssh + tmux" | Native Telegram/Discord UI — no SSH, no terminal on mobile | | "Cline is really burning up OpenRouter tokens and my wallet" | Built-in usage tracking and monthly budget limits per session |
Requirements: Node.js 20+ (the installer handles this for you)
curl -fsSL https://raw.githubusercontent.com/Open-ACP/OpenACP/main/scripts/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/Open-ACP/OpenACP/main/scripts/install.sh | bash
Works on Debian/Ubuntu, Fedora/RHEL, Arch, and other distros. Also supports WSL (Windows Subsystem for Linux).
Open PowerShell and run:
powershell -c "irm https://raw.githubusercontent.com/Open-ACP/OpenACP/main/scripts/install.ps1 | iex"
Requires PowerShell 5.1+ (built into Windows 10/11).
If you do not have Node.js yet, install it first. For example, on macOS or Linux with nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
nvm install --lts
nvm use --lts
Then install OpenACP with npm:
npm install -g @openacp/cli
openacp
# → Interactive setup wizard starts:
# → ? Choose your platform: Telegram / Discord / Slack
# → ? Enter your bot token: ********
# → ? Select workspace directory: ~/projects
# → ? Choose default AI agent: Claude Code
# → ✓ Configuration saved. Starting OpenACP...
# → 🚀 OpenACP is running. Send a message to your bot!
After installation, the interactive setup wizard walks you through everything:
That's it. Send a message to your bot and start coding.
Need detailed setup for a specific platform? See the Platform Setup guides.
| Platform | Status | Highlights | |----------|--------|------------| | Telegram | Stable | Forum topics per session, streaming, permission buttons, voice | | Discord | Stable | Thread-based sessions, slash commands, button interactions | | Slack | Stable | Socket Mode, channel-based sessions, thread organization |
/switch; history carries over automatically/handoff)/switch)openacp api ...)openacp doctor checks everything and suggests fixesFull feature documentation — Documentation
OpenACP uses the ACP Registry — new agents are available as soon as they're registered.
| Agent | Type | Description | |-------|------|-------------| | Claude Code | npx | Anthropic's Claude coding agent | | Gemini CLI | npx | Google's Gemini CLI | | Codex CLI | npx | OpenAI's coding assistant | | GitHub Copilot | npx | GitHub's AI pair programmer | | Cursor | binary | Cursor's coding agent | | Cline | npx | Autonomous coding agent | | goose | binary | Open source AI agent by Block | | Amp | binary | The frontier coding agent | | Auggie CLI | npx | Augment Code's context engine | | Junie | binary | AI coding agent by JetBrains | | Kilo | npx | Open source coding agent | | Qwen Code | npx | Alibaba's Qwen assistant | | ...and more | | Full registry → |
openacp agents # Browse all agents
openacp agents install <name> # Install from registry
# Server
openacp # Start (first run = setup wizard)
openacp start / stop /