About this project

Claude Gateway is an orchestrator, voice, and multi-channel platform for Claude Code. It keeps conversations responsive while Claude Code workers execute durable tasks in parallel. Users can talk or type through connected channels (Telegram, Discord, LINE, Slack, WhatsApp, Cron, and more), follow progress, and carry agent memory and skills across sessions. Key features include: - Agent orchestration engine with responsive conversations, durable tasks, progress reporting, follow-up instructions, and cancellation. - Voice conversations with speech recognition and spoken replies, per-agent models and voices, live or recorded input, and audio replay. - Skill self-improvement: agents learn reusable skills from their own work, with provenance guards and daily caps. - Knowledge base (two-lane memory) with per-agent SQLite/FTS5 searchable archive exposed via MCP tools. - Nightly dreaming: background consolidation of long-term memory with safe applier and budget management. - Multi-agent support: run multiple bots from a single gateway with isolated sessions. - Multi-channel MCP: modular tool system per channel. - Channel ingress recovery for unavailable attachments and retries. - Agent skills via SKILL.md files, with runtime creation, deletion, and installation from URLs. - Agent identity via workspace markdown files. - Live status messages, typing indicators, streaming API (SSE), auto-forward, heartbeat/scheduled tasks, persistent chat history, auto-cleanup, long-term memory, config auto-migration, access control, HTTP API, App Store for Docker-compose apps, self-update, session persistence, and optional PTY shell mode. Installation requires Node.js 22+, Bun, and an authenticated Claude Code CLI. Orchestration requires Linux. Docker/Compose is needed for apps; some voice formats require ffmpeg. Quickstart: `npm install -g @0xmaxma/claude-gateway`, then `claude-gateway gateway start` and `claude-gateway agents create`. Documentation covers configuration, orchestration, channels, voice, API, operations, and development. A `claude-gateway doctor` command checks dependencies and can fix common issues.