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

Control Panel Manage sessions, agents, and settings	Agent at Work Plans, reads files, writes code
Real-time Tool Calls See every action the agent takes	Agent Skills Brainstorming, TDD, debugging & more

Quick Start

npm install -g @openacp/cli
openacp

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

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)
• 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 / status      # Daemon management
openacp logs                       # Tail daemon logs

# Configuration
openacp config                     # Interactive config editor
openacp reset                      # Re-run setup wizard
openacp doctor                     # System diagnostics

# Sessions & API (requires running daemon)
openacp api new [agent] [workspace]
openacp api status
openacp api cancel <id>

# Tunnels
openacp tunnel add <port> [--label name]
openacp tunnel list

Full CLI reference — CLI Commands

Documentation

Star History

Contributing

We welcome contributions! See the contributing guide for development setup, testing conventions, and PR process.

Follow Us

License

MIT