remotty
v0.2.13
Published
Windows bridge that lets you talk to local Codex from Telegram.
Maintainers
Readme
remotty

remotty is not a general-purpose remote control tool.
It is a bridge for continuing Codex work on Windows from the Telegram app you
already use.
remotty lets you continue Codex work from Telegram.
There is no new mobile app to install.
You send a message to your Telegram bot. remotty receives it on your Windows
PC, sends it to the Codex CLI session you connected, and returns the reply to the same
Telegram chat.
remotty does not expose a public webhook server. It also does not type into
the open Codex App window. It talks to local Codex through the local codex
command.
What It Does
- Connects a Telegram bot to Codex on your Windows PC.
- Connects Telegram to the Codex CLI session you start for the project.
- Sends Telegram messages to that session.
- Queues text you send while Codex is already working.
- Returns Codex replies to the same Telegram chat.
- Relays approval prompts to Telegram.
- Stores the bot token in Windows protected storage.
- Stores
remottystate under%APPDATA%\remotty.
When To Use It
Use remotty when you want to leave your desk and keep steering the Codex work
that is available on your Windows PC.
Requirements
- Windows 10 or Windows 11
- Codex CLI
- Node.js and
npm - A Telegram bot token from
@BotFather
Rust is only needed when you build from source.
Get Started
Use the Telegram Quickstart.
It walks through installation, bot setup, token storage, pairing, channel startup, and a first Telegram test message.
Want to try the local loop before making a Telegram bot? Use the Fakechat Demo.
Update
Run this in a normal user PowerShell when you want the latest published
remotty package:
npm install -g remottyThen follow the Telegram Quickstart from the project you want to use.
Main Commands
Run these from PowerShell:
$configPath = Join-Path $env:APPDATA "remotty\bridge.toml"
remotty config workspace upsert --config $configPath --path (Get-Location).Path
remotty telegram configure --config $configPath
remotty --config $configPath
remotty telegram access-pair <code> --config $configPath
remotty telegram policy allowlist --config $configPathWhen remotty --config $configPath succeeds, the terminal prints
Listening for Telegram channel messages from: remotty:telegram.
Keep that terminal open while you use Telegram.
If you also use Codex App, the bundled plugin can help with setup tasks.
The plugin is optional. The supported Telegram flow is the Codex CLI flow above:
Codex CLI plus the remotty PowerShell commands.
Run these in Telegram:
/help
/status
/stop
/approve <request_id>
/deny <request_id>
/workspace
/workspace <id>Security
- Store bot tokens with
remotty telegram configureso they stay in Windows protected storage. - Use a dedicated Telegram bot for
remotty. - Do not paste bot tokens into chat, issues, or pull requests.
- Do not paste bot tokens or
api.telegram.org/bot...URLs into issues. - Keep project files separate from
%APPDATA%\remottyruntime state.
Related Docs
Note: if your project lives on an SSH host, Codex Remote connections may also
be useful. remotty is for returning to Codex work on your Windows PC from
Telegram.
License
Disclaimer
This is an unofficial community project. It is not affiliated with, endorsed by, or sponsored by OpenAI.
Codex, ChatGPT, and related marks are trademarks of OpenAI.
They are referenced here only to describe the local tools that remotty works
with. All other trademarks belong to their owners.
