Um servidor Node/Docker que conecta Telegram e GitHub a agentes de código (Claude Code ou Codex), com sessões que sobrevivem a restart, repositórios clonados sob demanda e comandos versionados no seu próprio codebase.
rAgentic-cs (Remote Agentic Coding System) roda como servidor Docker e faz a ponte entre plataformas de mensagem/issue e assistentes de IA de código — sem você precisar de um terminal aberto.
Fale com o agente pelo Telegram (chat) ou por menções em issues/PRs do GitHub. Mais plataformas planejadas no roadmap.
Escolha o assistente por codebase — detectado automaticamente pela pasta .claude/commands/ ou .codex/ do repositório clonado.
Conversa, codebase ativo e diretório de trabalho ficam salvos no Postgres — sobrevivem a reinício do container.
Uma mensagem chega por um adapter de plataforma, passa pelo orquestrador (roteamento + contexto), é resolvida como comando slash ou prompt livre, e vai pro assistente de IA configurado — tudo registrado em 3 tabelas Postgres.
Sistema + pelo menos uma conta de IA + pelo menos uma plataforma de interação.
Pra rodar o servidor (app + Postgres, se optar pelo banco local).
# checar instalação
docker --version
docker compose versionSó necessário se for rodar localmente sem Docker (npm run dev).
# checar versão
node --versionGitHub (clonar repos), Claude Pro/Max ou conta Codex, e Telegram ou GitHub pra interação.
# gerar token GitHub em https://github.com/settings/tokens # scope: repo
Setup local com Docker. Para deploy 24/7 numa VPS, veja o docs/cloud-deployment.md do repositório.
Copie o repositório e o arquivo de ambiente de exemplo.
git clone https://github.com/inematds/rAgentic-cs cd rAgentic-cs cp .env.example .env
Defina DATABASE_URL e o token de GitHub para clonar repositórios.
# .env DATABASE_URL=postgresql://postgres:postgres@postgres:5432/remote_coding_agent GH_TOKEN=ghp_seu_token_aqui GITHUB_TOKEN=ghp_seu_token_aqui # mesmo valor
Claude Code via claude setup-token (recomendado p/ assinantes Pro/Max) ou Codex via codex login.
# .env — Claude Code CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-xxxxx # .env — alternativa via API key CLAUDE_API_KEY=sk-ant-xxxxx
Telegram é o caminho mais simples: crie o bot com @BotFather e cole o token.
# .env TELEGRAM_BOT_TOKEN=123456789:ABCdefGHI... TELEGRAM_STREAMING_MODE=stream # stream (default) | batch
Escolha o profile do Docker Compose de acordo com o banco (local ou remoto).
# Opção A: Postgres remoto (Supabase, Neon...) docker compose --profile external-db up -d --build # Opção B: Postgres local via Docker docker compose --profile with-db up -d --build
No Telegram (ou numa issue do GitHub), clone o repo alvo e carregue os comandos slash dele.
/clone https://github.com/user/repo /load-commands .claude/commands
Pergunte livremente ou invoque um comando carregado, com argumentos.
/command-invoke plan "Add retry logic to API calls" /status # mostra plataforma, assistente, codebase e sessão ativa
Endpoints de health check para monitoramento e debug.
curl http://localhost:3000/health curl http://localhost:3000/health/db curl http://localhost:3000/health/concurrency
Dois caminhos de interação cobertos pelo projeto: chat no Telegram e menções em issues/PRs do GitHub.
Clone um repo, carregue .claude/commands/, e invoque /command-invoke prime pra pesquisar o codebase ou /command-invoke plan "Add dark mode" pra gerar um plano de implementação — tudo na conversa.
Mencione @remote-agent numa issue: @remote-agent can you analyze this bug?. Na primeira menção o bot clona o repositório e injeta o contexto completo da issue/PR; nas seguintes, resume a conversa mantendo o histórico.
O projeto já está funcional (adapters, orquestrador, comandos genéricos, Docker); o roadmap descrito no README é sobre expandir plataformas e assistentes suportados.
remote_agent_codebases, _conversations, _sessions).IAssistantClient, com detecção automática do assistente pela pasta de comandos do codebase clonado.IPlatformAdapter) preparada para novas plataformas além de Telegram e GitHub, conforme o README descreve ("e mais no futuro").