# README

**Control AI coding agents from your favorite messaging platform.**

OpenACP bridges AI coding agents to messaging platforms like Telegram, Discord, and Slack using the [Agent Client Protocol (ACP)](https://agentclientprotocol.com/). Send a message, and your AI agent writes code, runs commands, and streams results back — all from your phone or desktop.

## Why OpenACP?

* **28+ AI agents** — Claude Code, Gemini CLI, Codex, Copilot, Cursor, Cline, goose, and more
* **Any platform** — Telegram, Discord, Slack, or build your own adapter
* **Self-hosted** — Your machine, your API keys, your data. Nothing leaves your infrastructure.
* **Real-time streaming** — Watch your agent think, plan, and execute with live updates
* **Session management** — Persistent sessions, resume after restarts, transfer between devices

## Get Started

Choose the path that fits you:

| I want to...                                    | Start here                                                                   |
| ----------------------------------------------- | ---------------------------------------------------------------------------- |
| **Understand what OpenACP does**                | [What is OpenACP?](https://docs.openacp.ai/getting-started/what-is-openacp)  |
| **Install and start chatting** with an AI agent | [Quick Start](https://docs.openacp.ai/getting-started/quick-start)           |
| **Build plugins & adapters** for OpenACP        | [For Contributors](https://docs.openacp.ai/getting-started/for-contributors) |

Or start with [What is OpenACP?](https://docs.openacp.ai/getting-started/what-is-openacp) to understand the big picture.

## Quick Install

```bash
npm install -g @openacp/cli
openacp
```

***

[![npm](https://img.shields.io/npm/v/@openacp/cli)](https://www.npmjs.com/package/@openacp/cli) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)