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 already have Node.js 20+ installed:

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

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

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.

| 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

CLI Overview

# Server
openacp                            # Start (first run = setup wizard)
openacp start / stop / restart     # Daemon management
openacp status                     # Check daemon status
openacp logs                       # Tail daemon logs

# Configuration
openacp config                     # Interactive config editor
openacp reset                      # Re-run setup wizard
open