agent-chat-gateway 0.3.1

Daemon that bridges chat platforms (Rocket.Chat and more) to AI agent backends (Claude, OpenCode)

agent-chat-gateway

Turn your AI agent into a team-shared chatbot — in minutes.

Already running Claude Code or OpenCode? agent-chat-gateway connects it to your team's chat system (Rocket.Chat, and more) so everyone can talk to it directly from chat — no terminal required, no code changes to your agent.

Inspired by OpenClaw's vision of making AI agents accessible from any messaging app — built for the team layer.

How it compares to Claude Code Channels: Claude Code's native Channels feature connects a single session to Telegram, Discord, or iMessage — great for personal use. agent-chat-gateway is built for teams: multiple agents, multiple chat systems, per-user roles, human oversight for sensitive operations, and shared sessions across your whole workspace.

---

Features

• 💬 Works with Rocket.Chat — and extensible to Slack, Discord, or any other chat system you use
• 🤖 Bring your own agent — Claude Code and OpenCode work out of the box; plug in any other agent too
• 👥 User-aware in chat — the agent knows who sent each message and can personalize tone, language, and style per person using room profiles
• 🔒 Owner & Guest roles — control who can do what, with different permissions per role
• 🛡️ Human oversight for sensitive actions — the agent pauses and asks for your approval before executing risky operations like file writes or shell commands
• 🔗 Continue your session remotely — pin a chat room to an existing agent session and pick up right where you left off, from anywhere
• 📎 File attachments — send files in chat and the agent can read and work with them
• 🧠 Context injection — pre-load domain knowledge, system prompts, or project context into the agent at startup
• ⚡ Multiple chat systems at once — connect to several chat platforms simultaneously
• ⏰ Built-in task scheduler — let the agent schedule recurring or one-shot tasks directly from chat ("remind me in 5 minutes", "run daily standup at 09:00") without any infrastructure setup
• 🤝 Agent-to-agent collaboration — let multiple AI agents collaborate in a shared room; built-in loop protection keeps conversations bounded and human-observable

---

What's Supported

	Supported today	Can be extended
Chat platforms	Rocket.Chat	Slack, Discord, and others
Agent backends	Claude Code, OpenCode	Any agent with a CLI interface

---

Quick Start

Option A — AI-guided install (recommended)

The easiest way to install is to ask your AI agent to do it for you — it handles dependencies, configuration, and any troubleshooting automatically.

In Claude Code or OpenCode, run this prompt:

Please install agent-chat-gateway by following the instructions at https://raw.githubusercontent.com/HammerMei/agent-chat-gateway/main/docs/install-agent.md

Option B — Docker (no local dependencies)

If you'd rather skip installing Python, Node.js, or Claude Code locally, run ACG in a container:

# 1. Copy the example directory to your deployment location
cp -r docker/docker-compose.example my-acg
cd my-acg

# 2. Fill in your credentials and settings
#    .env          — Claude Code OAuth token (see file for instructions)
#    config/.env   — Rocket.Chat URL, username, password
#    config/config.yaml — owners, rooms, agents

# 3. Start
docker compose up -d

# Logs
docker compose logs -f

See docker/docker-compose.example/ for the full annotated setup — all files are pre-structured and ready to fill in.

Prefer a native install? See INSTALL.md for step-by-step instructions.

---

Running the Gateway

# Start the gateway
agent-chat-gateway start

# Check status
agent-chat-gateway status

# Stop the gateway
agent-chat-gateway stop

See docs/user-guide.md for the full CLI reference, configuration options, and usage examples.

---

Documentation

Document	Description
INSTALL.md	Manual installation guide
docs/user-guide.md	Configuration reference, CLI usage, and operational guide
docs/architecture.md	System architecture and module breakdown
docs/permission-reference.md	Roles, permissions, and human oversight deep dive
docs/supported-features.md	Supported features, known limitations, and roadmap
docs/requirements.md	Functional specification and behavioral requirements
docs/scheduling.md	Built-in task scheduler — recurring and one-shot jobs from chat
docs/agent-chain.md	Agent-to-agent collaboration — enabling multiple heterogeneous AI agents to coordinate via chat