acpbot

Agent Client Protocol · Telegram · Local-first

Your agents. In chat.

acpbot is the Telegram control surface for ACP coding agents. Each forum topic is a live session with Grok, Claude, Codex, or OpenCode — permissions, media, MCP tools, and schedules on your machine.

Get started See the architecture
Grok Build Claude Codex OpenCode

Capabilities

Built for real operator work

Not a toy chat wrapper — a durable bridge between Telegram and the Agent Client Protocol.

Topic = session

/new opens a private forum topic bound to a repo and agent. History, mode, and model stay with that thread.

acp-host required

Agent stdio lives in a long-lived host process. Restart the Telegram worker without killing agent context.

Permissions in-line

ACP permission requests, elicitation, and ask-user flows become Telegram keyboards — approve, reject, or cancel where you already are.

Models & modes

/model, /effort, and /mode read live agent catalogs over ACP — reasoning effort and permission modes when advertised.

Media & speech

Photos, files, voice STT in; agent TTS out. OpenAI and ElevenLabs are selectable per TTS/STT via config.toml.

Schedules

Durable in-repo jobs. The host can fire them even when the worker is offline.

Architecture

Local daemon. Real agents.

You (Telegram)
    │  forum topic
    ▼
acpbot worker  ──Unix──►  acp-host  ──stdio──►  grok / claude / codex / opencode
    │                        │
    ├── worker-api.sock      └── sessions · OAuth · schedules
    └── single operator (CLI pair approve)
  • Single operator — private chat; pair with a Telegram code + acpbot pair approve on the host.
  • Local-first — tokens and agent processes stay on your box (or your tailnet).
  • ACP native — session/new|load, prompt, cancel, set_mode, models, MCP.

Agents

Pick the process. Keep the topic.

Switch agent mid-session with /agent. PATH-gated picker — only installed CLIs appear.

Grok Build

grok agent stdio

effort modes · session load

Claude

via claude-agent-acp

official ACP adapter

Codex

via codex-acp

read-only · agent modes

OpenCode

opencode acp

native ACP · rich models

Ship from the chat you already live in.

Open source. Local agents. Binary install in minutes — quick start docs.

Get started