v0.1.0 — first public release

First public release.

Text your own private Telegram bot, and the message runs as a Grok turn on your computer. Grok's finished answer comes back to your phone.

This is a sibling of the Claude Telegram Bridge and the Codex Telegram Bridge. It targets Grok specifically and shares no runtime code with either.

Read the security section before installing

This bridge gives a chat app the ability to run commands on your computer. Grok is allowed to use its real tools: run shell commands, read files, edit files, run git.

The only thing between the internet and your machine is one check — the bridge compares the Telegram chat id of every incoming message against the single chat id you configured, and discards everything else. There is no command allowlist, no approval prompt, no sandbox, and no second factor.

Never share your bot token, never add the bot to a group, and do not run this on a machine you cannot afford to have damaged. The README covers this in full; please read it first.

What is in this release

• Telegram long-polling loop with single-chat-id enforcement
• Two lanes: a headless lane and a terminal (tmux) lane that mirrors a live Grok session
• Typing and progress indicators while a turn is running
• Idle-based waiting: a turn that keeps making progress keeps going, while a silent turn is cut, so long tool-using work is no longer truncated at a fixed deadline
• Account profile separation, so more than one Grok account can be used from separate home directories
• Session launcher with retry on startup, so a restart that fails once does not leave you with no window
• Example configuration file and a public test suite

Requirements

Python 3, tmux for the terminal lane, and the Grok CLI installed and signed in.

Install

Clone the repository, copy the example configuration, fill in your bot token and chat id, then run the bridge. Step-by-step instructions are in the README.