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.

OpenACP

Control AI coding agents from Telegram, Discord & Slack

Send a message. The agent writes code. You see everything — in real time.

= 20">

Documentation · Quick Start · Features · Agents · Contributing · Discussions

What is OpenACP?

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

Why OpenACP?

Use Cases

• Remote coding — Tired of being chained to your desk to run Claude Code? Review PRs, fix bugs, and deploy from your phone via Telegram while away from your desk.
• Team visibility — Share a Discord channel where everyone sees what the AI agent is doing in real time — no more black-box coding sessions.
• Multi-agent workflows — Start with Claude Code for planning, switch to Codex for implementation, use Gemini for review — all in one chat thread, no reconfiguration.
• CI/CD integration — Trigger agent sessions from GitHub Actions or any issue tracker via the REST API.
• Self-hosted AI gateway — Keep API keys and code on your own infrastructure. No third-party cloud, no vendor lock-in.
• Local LLM support — Run agents against self-hosted models (Ollama, LM Studio) via ACP-compatible adapters. Your models, your data.

Installation

Requirements: Node.js 20+ (the installer handles this for you)

macOS

curl -fsSL https://raw.githubusercontent.com/Open-ACP/OpenACP/main/scripts/install.sh | bash

Linux

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).

Windows

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).

Manual install via npm

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:

1. Choose your platform (Telegram, Discord, Slack, or multiple)
2. Connect your bot (token validation + auto-detection)
3. Pick a workspace directory
4. Select your default AI agent
5. Choose run mode (foreground or daemon)

That's it. Send a message to your bot and start coding.

Need detailed setup for a specific platform? See the Platform Setup guides.

Features

Messaging Platforms

Core

• 28+ AI agents — Claude Code, Codex, Gemini, Cursor, Copilot, and more
• Session management — Each conversation gets its own thread/topic with auto-naming
• Session persistence — Sessions survive restarts, with configurable TTL
• Permission control — Approve or deny agent actions via buttons, with optional auto-approve
• Real-time streaming — See agent thinking, tool calls, and output as they happen
• Agent switching — Switch agents mid-conversation with /switch; history carries over automatically

Developer Tools

• Tunnel & port forwarding — Expose local ports to the internet (Cloudflare, ngrok, bore, Tailscale)
• Built-in file viewer — Monaco Editor with syntax highlighting, diffs, and markdown preview
• Session transfer — Move sessions between terminal and chat (/handoff)
• Agent switch — Change which AI agent handles your session mid-conversation (/switch)
• Voice & speech — Send voice messages, get spoken responses (Groq STT + Edge TTS)
• Usage tracking — Token counts, cost reports, optional monthly budget limits
• Context resume — Resume sessions with full conversation history

Operations

• Daemon mode — Run as a background service with auto-start on boot
• CLI API — Full REST API for automation (openacp api ...)
• Plugin system — Install adapters as npm packages
• Doctor diagnostics — openacp doctor checks everything and suggests fixes
• Structured logging — Pino with rotation, per-session log files

Full feature documentation — Documentation

Supported Agents

OpenACP uses the ACP Registry — new agents are available as soon as they're registered.

openacp agents                     # Browse all agents
openacp agents install <name>      # Install from registry

CLI Overview

# Server
openacp                            # Start (first run = setup wizard)
openacp start / stop /