Skip to main content
How-To Guides Last updated: 8 October 2026

Uninstall Untether

1. Open Telegram and message @BotFather 2. Send /deletebot 3. Select your bot from the list

Nathan Schram
By Founder, Little Bear Apps

1. Stop the service

If Untether is running as a systemd service, stop it first:

systemctl --user stop untether
systemctl --user disable untether

2. Remove the CLI

uv

uv tool uninstall untether

pipx

pipx uninstall untether

3. Remove configuration and state

Untether stores all config and state in ~/.untether/ (or the path set by UNTETHER_CONFIG_PATH):

rm -rf ~/.untether/

This deletes:

FileContains
untether.tomlBot token, chat ID, engine settings, transport config
*_state.jsonChat preferences, session resume tokens, topic bindings
active_progress.jsonOrphan message references (restart recovery)
active_loops.jsonPending Claude Code loop iterations (Loop mode)
stats.jsonPer-engine run counts and usage statistics
session_costs.json, session_quarantine.jsonPer-session cost baselines and quarantined Claude sessions
daily_cost.jsonToday’s running API cost total, used by max_cost_per_day and /health
triggers_history.json, run_once_fired.json, run_once_pending.jsonLast-fired times for crons and webhooks, spent run_once crons, run_once crons waiting on a send retry
last_update_id.json, untether.lockTelegram update offset and the single-instance lock

Bot token

untether.toml contains your Telegram bot token in plaintext. Deleting the file removes it from disk.

4. (Optional) Delete the Telegram bot

Removing Untether does not delete the Telegram bot itself. If you no longer need it:

  1. Open Telegram and message @BotFather
  2. Send /deletebot
  3. Select your bot from the list

5. (Optional) Remove agent CLIs

If you no longer need the agent CLIs that Untether wrapped:

npm uninstall -g @anthropic-ai/claude-code
npm uninstall -g @openai/codex
npm uninstall -g opencode-ai
npm uninstall -g @mariozechner/pi-coding-agent
npm uninstall -g @google/gemini-cli
npm uninstall -g @sourcegraph/amp
Was this helpful?

Related Articles

ReferenceCommands & directivesThis page documents Untether’s user-visible command surface: message directives, in-chat commands, and the CLI.ReferenceError ReferenceWhen an engine fails, Untether scans the error message and shows an actionable recovery hint above the raw error.ReferenceTelegram TransportTelegramClient is the single transport for Telegram writes. It owns a TelegramOutbox that serialises send/edit/delete operations, applies coalescing…