Vibeleaderboard
← Back to Tools
Index / agent

Remote Agentic Coding System

https://github.com/coleam00/remote-agentic-coding-system
Visit github.com
Category
AI Agents
Rank
No. 1122Tools index
Pricing
Open Source
Type
AGENT
Builder
coleam00
GitHub
350 stars
Date

About

Connect Claude Code or Codex to Slack, Telegram, and GitHub for remote agentic coding workflows.

What it does

A self-hosted orchestration service that keeps coding-assistant conversations and repository context in PostgreSQL. It clones repositories, resumes assistant sessions, streams or batches responses, and lets teams store reusable commands alongside their code.

Why it's ranked here

The architecture has useful boundaries between messaging platforms, assistants, and persistence. Telegram and GitHub workflows are concrete, not just promised. However, startup still requires Telegram credentials, testing is largely unfinished, and the implementation grants Claude unrestricted tool approval.

What's good

Conversation and assistant session records survive container restarts. GitHub mentions receive issue or pull-request context, repositories clone automatically, and command definitions can load from repository folders. Per-conversation locking limits concurrent work, while webhook signatures protect GitHub inputs.

Tradeoffs

This is infrastructure, not a hosted product. It needs PostgreSQL, assistant credentials, a GitHub token with repository scope, and Docker or Node.js. Telegram is mandatory at startup even when GitHub is configured. GitHub repository paths enter shell commands, Claude auto-approves tools, and Codex tests are placeholders.

How to use it well

Use it for a trusted, self-hosted development environment where remote prompts should preserve context across sessions. Start with one controlled repository and narrow credentials. It does not provide a demonstrated Slack adapter, broad automated test coverage, or managed hosting.

Technical notes+

src/index.ts starts Express, PostgreSQL, the test adapter, optional GitHubAdapter, and mandatory TelegramAdapter; it also creates a ConversationLockManager with a configurable concurrency ceiling. src/types/index.ts defines common platform and assistant interfaces. src/clients/claude.ts runs the Claude Agent SDK with permissionMode: 'bypassPermissions', while src/clients/codex.ts dynamically imports the ESM-only Codex SDK and persists thread IDs from completion events. src/adapters/github.ts verifies HMAC SHA-256 webhook signatures, clones or resets repositories through child-process shell commands, and loads Markdown commands. src/db/sessions.ts, src/db/codebases.ts, and src/db/conversations.ts persist state in PostgreSQL. src/clients/codex.test.ts contains only a passing placeholder and TODOs for mocked coverage.

Observed

License
MIT
Primary language
TypeScript
Runtime and packaging
Node.js 20 or newer, npm scripts, and Docker Compose deployment profiles
Interfaces
Telegram bot polling, GitHub webhooks, and Express health and test HTTP endpoints
Assistant support
Claude Agent SDK and OpenAI Codex SDK
Persistence
PostgreSQL stores codebases, conversations, and assistant sessions
Test structure
The provided Codex test is a placeholder requiring manual integration testing

Read from README.md, package.json, src/index.ts, src/types/index.ts, src/db/sessions.ts, src/db/codebases.ts, src/adapters/test.ts, src/clients/codex.ts, src/db/connection.ts, src/clients/claude.ts, src/adapters/github.ts, src/clients/factory.ts, src/db/conversations.ts, src/adapters/telegram.ts, src/clients/codex.test.ts.

What it can do

  • Generate code from natural language prompts

    Natural language description of coding task → Generated code files

  • Review and analyze code repositories

    GitHub repository URL or code files → Code analysis and suggestions

  • Create GitHub pull requests

    Code changes and commit messages → GitHub pull request

  • Execute coding workflows via Slack commands

    Slack messages with coding requests → Code generation and repository updates

  • Execute coding workflows via Telegram commands

    Telegram messages with coding requests → Code generation and repository updates

  • Automatically commit code changes to repositories

    Generated or modified code → Git commits pushed to repository

  • Debug and fix code issues

    Broken code or error descriptions → Fixed code with corrections

Tags

claude-codecodexremote-agentslacktelegram

Tech Stack

Node.jsDockerTypeScript

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.