This project provides a remote coding environment by integrating AI coding assistants like Claude Code and Codex with communication platforms such as Telegram and GitHub. It targets developers seeking persistent coding sessions and flexible workflows, enabling them to code from anywhere by connecting AI capabilities to their development tools.

How It Works

The system employs an orchestrator pattern, routing messages from platform adapters (Telegram, GitHub) to AI assistant clients (Claude, Codex). It leverages a PostgreSQL database for session persistence and codebase metadata. A key feature is its generic command system, allowing user-defined commands stored as Git-versioned markdown files within codebases, promoting a flexible and integrated workflow. The architecture utilizes Adapter and Strategy design patterns for modularity.

Quick Start & Requirements

Deployment is primarily via Docker Compose. Prerequisites include Docker, Node.js 20+ (for local dev), a GitHub account, access to Claude Code or Codex, a Telegram or GitHub account for interaction, and PostgreSQL. Users need to configure environment variables for API keys (GitHub token, Claude/Codex credentials) and database connections. Setup involves cloning the repository, configuring .env files, and setting up AI assistant and platform adapter credentials. Links to CLI installations and GitHub token setup are provided.

Highlighted Details

• Multi-Platform Integration: Supports interaction via Telegram and GitHub issues/PRs.
• AI Assistant Flexibility: Integrates with both Claude Code and Codex.
• Persistent Sessions: Maintains full context across container restarts.
• Codebase Management: Enables cloning and direct work on any GitHub repository.
• Git-Versioned Commands: Custom commands are defined in markdown files within the codebase, version-controlled alongside the code.
• Configurable Streaming: Offers real-time (stream) or batched message delivery per platform.

Maintenance & Community

The provided README does not contain specific details regarding maintainers, community channels (e.g., Discord, Slack), or project roadmap.

Licensing & Compatibility

The project's license is not explicitly stated in the provided README content. Compatibility for commercial use or closed-source linking is therefore undetermined.

Limitations & Caveats

Local development requires Node.js 20+. GitHub webhook setup for local testing necessitates tunneling services like ngrok, whose free tier URLs are ephemeral. Production deployment details are referenced in a separate guide not included here. The project relies on external AI services requiring specific subscriptions or accounts.