Untether

Telegram bridge for AI coding agents.
  Send tasks by voice or text, stream progress live, and approve changes — from your phone, anywhere.

  🌐 untether.cc · 📖 Help guides

  Quick start · Features · Engines · Docs · Contributing

Your AI coding agents need a terminal, but you don't need to sit at one. Untether runs on your machine (or server) and connects Claude Code, Codex, OpenCode and Pi to a Telegram bot. Send a task from your phone, watch the agent work in real time, tap a button when it needs permission, and read the result when it's done — no desk, no SSH, no screen sharing. The agent keeps running if you close Telegram or lose signal.

* Feature availability varies by engine — see engine compatibility

⚡ Quick start

You need Python 3.12+, uv (or pipx), and at least one agent CLI on your PATH (claude, codex, opencode or pi).

The wizard creates your Telegram bot (or takes an existing token), picks a workflow mode — assistant, workspace or handoff — and connects your chat. Then message your bot:
fix the failing tests in src/auth

Step-by-step: Install and onboard → First run. Update with uv tool upgrade untether (or pipx upgrade untether), then send /restart from Telegram — see Update Untether.
Upgrading from 0.35.x? v0.36.0 has breaking changes (the auto permission mode is now plan-auto, unattended crons deny approvals, Codex safe mode is a real read-only sandbox, and more). Read Upgrading to v0.36.0 first.

🎯 What you get

- 📡 Live progress — tool calls, file changes and elapsed time stream into one message as the agent works (verbose progress)
- 🔐 Approvals from your phone (Claude) — approve tool calls, plans and clarifying questions with inline buttons; four permission modes via /planmode (interactive approval, plan mode)
- ↪️ Live sessions and…