Headcrab

Headcrab / telecodex

Public

Telegram bridge for running your local Codex CLI remotely with topic-aware sessions, attachments, and streamed replies.

15
1
100% credibility
Found Mar 17, 2026 at 15 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

Telecodex connects a local AI coding tool to Telegram chats and topics for remote interaction with file sharing, session persistence, and streamed responses.

How It Works

1
🔍 Discover Telecodex

You hear about a clever way to chat with your local coding helper from anywhere using Telegram on your phone or computer.

2
📱 Set up your helper

You add a personal bot in Telegram and link it to your local coding assistant with a few simple steps.

3
🔐 Sign in safely

The bot guides you to securely connect your AI account using a one-time code right in the chat.

4
💬 Chat and share files

You type questions, send code files or images in chats or topics, and see real-time thinking and answers stream back.

5
📂 Organize your projects

Create separate topics for different coding tasks, switch between past sessions, and import your work history effortlessly.

Code on the go privately

Your powerful local AI is now accessible everywhere through Telegram, keeping all your work safe on your own machine.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 15 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is telecodex?

Telecodex is a Rust-built Telegram bridge bot that exposes your local Codex CLI as a remote frontend in Telegram chats or forum topics. It solves the hassle of terminal-only access by enabling persistent, topic-aware sessions with streamed replies, attachment handling for files/images/audio/video, and commands like `/new`, `/use`, `/login`, or `/review`. Everything stays local—no webhooks or cloud relays—with SQLite for user ACLs and optional audio transcription via ffmpeg.

Why is it gaining traction?

Unlike generic telegram bridges for Discord or Matrix, this one is Codex-first: import CLI/Desktop history by workspace, bind sessions to existing threads, and get artifacts back automatically. Developers dig the "remote terminal" feel from phone/desktop, with safety like sandbox modes, approval policies, and admin controls, all via long polling and editable messages for live progress.

Who should use this?

Codex CLI users needing mobile access for quick fixes or reviews in repos. Teams in Telegram forums sharing AI-assisted coding sessions per topic. Power users handling attachments in workflows, like transcribing voice notes into code prompts or reviewing git diffs remotely.

Verdict

Worth a spin for Telegram-savvy Codex fans—solid README with quickstart, Russian docs, and MIT license—but at 15 stars and 1.0% credibility, it's early alpha: test thoroughly before production. Pair with go-task for easy builds.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.