{"id":47731615,"url":"https://github.com/hammermei/agent-chat-gateway","last_synced_at":"2026-04-19T23:04:09.290Z","repository":{"id":348160198,"uuid":"1196534314","full_name":"HammerMei/agent-chat-gateway","owner":"HammerMei","description":"A gateway that bridges chat platforms (Rocket.Chat and more) to AI agent backends (Claude Code, OpenCode)","archived":false,"fork":false,"pushed_at":"2026-04-04T02:36:46.000Z","size":857,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T23:18:38.627Z","etag":null,"topics":["ai-agent","automation","chatbot","claude-code","gateway","llm","opencode","python","rocketchat","rocketchat-bot","self-ho"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HammerMei.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"docs/supported-features.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-30T19:44:18.000Z","updated_at":"2026-04-03T08:24:19.000Z","dependencies_parsed_at":"2026-04-04T23:00:32.753Z","dependency_job_id":null,"html_url":"https://github.com/HammerMei/agent-chat-gateway","commit_stats":null,"previous_names":["hammermei/agent-chat-gateway"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/HammerMei/agent-chat-gateway","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerMei%2Fagent-chat-gateway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerMei%2Fagent-chat-gateway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerMei%2Fagent-chat-gateway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerMei%2Fagent-chat-gateway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HammerMei","download_url":"https://codeload.github.com/HammerMei/agent-chat-gateway/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerMei%2Fagent-chat-gateway/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31454200,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"ssl_error","status_checked_at":"2026-04-05T21:22:51.943Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","automation","chatbot","claude-code","gateway","llm","opencode","python","rocketchat","rocketchat-bot","self-ho"],"created_at":"2026-04-02T21:40:30.751Z","updated_at":"2026-04-19T23:04:09.283Z","avatar_url":"https://github.com/HammerMei.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agent-chat-gateway\n\n[![CI](https://github.com/HammerMei/agent-chat-gateway/actions/workflows/ci.yml/badge.svg)](https://github.com/HammerMei/agent-chat-gateway/actions/workflows/ci.yml)\n[![Docker](https://ghcr-badge.egpl.dev/hammermei/agent-chat-gateway/latest_tag?trim=major\u0026label=docker\u0026color=blue)](https://github.com/HammerMei/agent-chat-gateway/pkgs/container/agent-chat-gateway)\n![Python](https://img.shields.io/badge/python-%3E%3D3.12-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n\n**Turn your AI agent into a team-shared chatbot — in minutes.**\n\nAlready 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.\n\nInspired by [OpenClaw](https://github.com/openclaw/openclaw)'s vision of making AI agents accessible from any messaging app — built for the team layer.\n\n\u003e **How it compares to Claude Code Channels:** Claude Code's native [Channels](https://code.claude.com/docs/en/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.\n\n---\n\n## Features\n\n- 💬 **[Works with Rocket.Chat](docs/supported-features.md#chat-platform-connectors)** — and extensible to Slack, Discord, or any other chat system you use\n- 🤖 **[Bring your own agent](docs/supported-features.md#agent-backends)** — Claude Code and OpenCode work out of the box; plug in any other agent too\n- 👥 **[User-aware in chat](docs/user-guide.md#user-aware-responses)** — the agent knows who sent each message and can personalize tone, language, and style per person using room profiles\n- 🔒 **[Owner \u0026 Guest roles](docs/permission-reference.md#roles)** — control who can do what, with different permissions per role\n- 🛡️ **[Human oversight for sensitive actions](docs/permission-reference.md#approval-workflow)** — the agent pauses and asks for your approval before executing risky operations like file writes or shell commands\n- 🔗 **[Continue your session remotely](docs/user-guide.md#use-case-3--continue-an-existing-agent-session-remotely)** — pin a chat room to an existing agent session and pick up right where you left off, from anywhere\n- 📎 **[File attachments](docs/user-guide.md#attachment-handling)** — send files in chat and the agent can read and work with them\n- 🧠 **[Context injection](docs/user-guide.md#context-files)** — pre-load domain knowledge, system prompts, or project context into the agent at startup\n- ⚡ **[Multiple chat systems at once](docs/user-guide.md#multi-connector-setup)** — connect to several chat platforms simultaneously\n- ⏰ **[Built-in task scheduler](docs/scheduling.md)** — 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\n- 🤝 **[Agent-to-agent collaboration](docs/agent-chain.md)** — let multiple AI agents collaborate in a shared room; built-in loop protection keeps conversations bounded and human-observable\n\n---\n\n## What's Supported\n\n| | Supported today | Can be extended |\n|--|--|--|\n| **Chat platforms** | Rocket.Chat | Slack, Discord, and others |\n| **Agent backends** | Claude Code, OpenCode | Any agent with a CLI interface |\n\n---\n\n## Quick Start\n\n### Option A — AI-guided install (recommended)\n\nThe easiest way to install is to ask your AI agent to do it for you — it handles dependencies, configuration, and any troubleshooting automatically.\n\nIn Claude Code or OpenCode, run this prompt:\n\n```\nPlease install agent-chat-gateway by following the instructions at https://raw.githubusercontent.com/HammerMei/agent-chat-gateway/main/docs/install-agent.md\n```\n\n### Option B — Docker (no local dependencies)\n\nIf you'd rather skip installing Python, Node.js, or Claude Code locally, run ACG in a container:\n\n```bash\n# 1. Copy the example directory to your deployment location\ncp -r docker/docker-compose.example my-acg\ncd my-acg\n\n# 2. Fill in your credentials and settings\n#    .env          — Claude Code OAuth token (see file for instructions)\n#    config/.env   — Rocket.Chat URL, username, password\n#    config/config.yaml — owners, rooms, agents\n\n# 3. Start\ndocker compose up -d\n\n# Logs\ndocker compose logs -f\n```\n\nSee [`docker/docker-compose.example/`](docker/docker-compose.example/) for the full annotated setup — all files are pre-structured and ready to fill in.\n\n\u003e Prefer a native install? See [INSTALL.md](INSTALL.md) for step-by-step instructions.\n\n---\n\n## Running the Gateway\n\n```bash\n# Start the gateway\nagent-chat-gateway start\n\n# Check status\nagent-chat-gateway status\n\n# Stop the gateway\nagent-chat-gateway stop\n```\n\nSee [docs/user-guide.md](docs/user-guide.md) for the full CLI reference, configuration options, and usage examples.\n\n---\n\n## Documentation\n\n| Document | Description |\n|---|---|\n| [INSTALL.md](INSTALL.md) | Manual installation guide |\n| [docs/user-guide.md](docs/user-guide.md) | Configuration reference, CLI usage, and operational guide |\n| [docs/architecture.md](docs/architecture.md) | System architecture and module breakdown |\n| [docs/permission-reference.md](docs/permission-reference.md) | Roles, permissions, and human oversight deep dive |\n| [docs/supported-features.md](docs/supported-features.md) | Supported features, known limitations, and roadmap |\n| [docs/requirements.md](docs/requirements.md) | Functional specification and behavioral requirements |\n| [docs/scheduling.md](docs/scheduling.md) | Built-in task scheduler — recurring and one-shot jobs from chat |\n| [docs/agent-chain.md](docs/agent-chain.md) | Agent-to-agent collaboration — enabling multiple heterogeneous AI agents to coordinate via chat |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhammermei%2Fagent-chat-gateway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhammermei%2Fagent-chat-gateway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhammermei%2Fagent-chat-gateway/lists"}