Getting Started with Untether

Set up Untether to control AI coding agents from Telegram on your phone.

What you’ll need

Python 3.11+ installed on your server or development machine
A Telegram account and the Telegram app
Claude Code, OpenCode, or another supported AI coding agent installed on the machine

Install

The recommended way to install Untether is with uv:

uv tool install untether

Or with pipx:

pipx install untether

Create a Telegram bot

Open Telegram and message @BotFather
Send /newbot and follow the prompts to create your bot
Copy the bot token BotFather gives you

Configure Untether

Initialise in your project directory:

cd /path/to/your/project
untether init myproject

This creates a config file at ~/.untether/untether.toml. Add your bot token and Telegram user ID.

Start the bridge

untether start

Untether connects your Telegram bot to your coding agent. Send tasks by voice or text, watch progress in real time, and approve changes — all from your phone.

Try your first task

Open Telegram and message your bot:

/claude Fix the login bug in auth.py

Or send a voice note describing what you need — Untether transcribes it automatically.

What’s next

Check the build page for supported agents and advanced configuration
Found a bug? Report it on GitHub
Have a question? Ask in Discussions

Was this helpful?