How-To Guides

Untether has three workflow modes that control how conversations continue and how sessions are organised. Each mode suits a different working style. · 3 min read

Bind a chat or forum topic to a specific project and branch, so every message runs in the right directory automatically — no need to prefix with /<project> e... · 2 min read

Running agents remotely means they can rack up costs while you're not watching. Untether tracks API costs per run and per day, with configurable budget limit... · 4 min read

Resume a coding session you started in your terminal — from Telegram, while away from your desk. · 3 min read

Set up Untether for local development, run checks, and test changes safely via the dev instance before releasing to production. · 3 min read

Untether records session events as they stream from the agent, so you can export a full transcript of any run directly from Telegram — review what your agent... · 2 min read

Send files to your repo or pull results back — directly from Telegram on any device. Useful when you need to share a spec, screenshot, or config file with yo... · 4 min read

Untether works in Telegram group chats, letting multiple people interact with coding agents from any device. This guide covers adding the bot to a group, res... · 3 min read

Adjust Untether's behaviour without editing config files or restarting — tap buttons right in Telegram. The /config command opens an interactive settings men... · 5 min read

When Claude Code runs in permission mode, Untether shows inline buttons in Telegram so you can approve or deny tool calls from your phone. · 5 min read

Untether lets you override which model the agent uses and its reasoning level, per chat or per engine — all from Telegram, without editing config files or re... · 2 min read

Untether runs as a long-lived process, typically in a terminal or managed by a process supervisor (systemd on Linux, etc.). This guide covers health checks, ... · 7 min read

When you're away from the terminal, you need confidence that your agent won't go off-script. Plan mode controls how Claude Code handles permission requests t... · 5 min read

Untether injects a context preamble at the start of every agent prompt, telling the engine it's running via Telegram and requesting structured end-of-task su... · 3 min read

Projects let you target any registered repo from Telegram — no need to restart Untether or change directories. Send /myapp fix the tests from your phone and ... · 1 min read

Bind a Telegram chat to a project so messages in that chat automatically route to the right repo. · 1 min read

There are several ways to run tasks on a schedule: the /at command for quick one-shot delays, Telegram's built-in message scheduling, and Untether's trigger ... · 3 min read

Untether gives remote access to coding agents on your server, so locking down who can interact with the bot and what files they can access is important. This... · 6 min read

See how much work your agents have done while you've been away. The /stats command shows per-engine session statistics — run counts, action totals, and durat... · 2 min read

Keep tabs on your Claude Code subscription from anywhere — Untether surfaces usage directly in Telegram. This guide covers checking usage on demand and enabl... · 2 min read

Different tasks suit different agents. Switch engines on the fly — use Claude Code for deep refactors, Codex for quick fixes — without restarting or reconfig... · 2 min read

Topics bind Telegram forum threads to a project/branch context. Each topic keeps its own session and default engine, which is ideal for teams or multi-projec... · 3 min read

Common issues and fixes for Untether. If your agent isn't responding, messages aren't arriving, or something looks off — start here. · 16 min read

If Untether is running as a systemd service, stop it first: · 1 min read

Untether publishes releases to PyPI. To upgrade to the latest version: · 2 min read

Untether shows progress messages as the agent works, updating in real time. Control how much detail you see — from compact summaries to full tool details — s... · 2 min read

Dictate coding tasks hands-free — while walking, driving, or away from a keyboard. Untether transcribes your Telegram voice notes via a Whisper-compatible en... · 1 min read

Untether can start agent runs automatically from external events (webhooks) or on a schedule (cron). Both use the same engine pipeline as Telegram messages, ... · 6 min read

Run tasks on multiple branches in parallel without touching your main checkout. Untether creates isolated git worktrees so you can kick off work on @feat/aut... · 1 min read

Untether supports entrypoint-based plugins for engines, transports, and commands. · 2 min read

Read individual emails and full conversation threads, with options for body content, previews, and forensic headers. · 2 min read

Decline, cancel, or delete calendar events, with an optional message to organisers or attendees. · 2 min read

Compose and send emails with dry-run preview, and understand the safety controls that prevent accidental sends. · 3 min read

Mark emails as read or unread, flag them for follow-up with due dates, and bulk-flag multiple messages. · 2 min read

Use mail tips to check for out-of-office, mailbox full, delivery restrictions, and other issues before sending an email. · 3 min read

List, view, and download email attachments to your local machine. · 2 min read

Save emails as drafts for review, update them, then send when ready. Reply and forward as drafts too. · 3 min read

Save emails and conversation threads to your local machine in Markdown, EML, MBOX, JSON, HTML, or CSV formats. · 3 min read

Search your contacts, organisational directory, and recent communications to find people quickly. · 2 min read

Create, view, update, and delete contact records in your Outlook contacts book. · 2 min read

Combine rules, categories, folders, and Focused Inbox to build a complete inbox management system through your AI assistant. · 3 min read

Automate email organisation with rules that move, mark, forward, or filter incoming mail based on sender, subject, body, attachments, and more — with exceptions and dry-run preview. · 5 min read

Force specific senders into Focused or Other to control which emails surface by default. · 1 min read

List, create, and manage mail folders, move emails between folders, and check folder statistics. · 2 min read

Create colour-coded category labels and apply them to emails for visual organisation and filtering. · 2 min read

Set your working hours and time zone so Outlook knows when you're available for scheduling. · 1 min read

Enable automatic replies when you're away, with separate messages for internal and external senders. · 2 min read

Read emails from shared mailboxes your account has been granted access to, such as team inboxes or service accounts. · 2 min read

Flag, export, move, or categorise multiple emails at once using batch parameters. · 2 min read

Search your organisation's meeting room directory by building, floor, capacity, or name. · 2 min read

Read forensic email headers to verify sender authenticity, trace delivery paths, check DKIM/SPF results, and analyse spam scores. · 3 min read

Use Keyword Query Language to write precise search queries for emails by date, sender, subject, and message properties. · 2 min read