two open-source command-line tools

Find the ID. Search the history. Send, create, clear.

Telegram and Discord bury the IDs everything else needs, and make a few jobs oddly hard — emptying a topic, exporting a thread, editing your bot. Type either tool's name and a menu opens; everything runs on your own machine.

telegram-tools

Your own Telegram account, from the command line.

telegram-tools

--------------------------------------------

1. Find IDs (chats, topics)

2. Read (search live, archive, export)

3. Write (send, reply, message tools)

4. Build (create, delete, structure)

5. Clear messages

6. Manage (admins, members, invites, settings)

7. Watch (rules, runner, review queue)

8. Identity (profiles, my bots)

9. Check setup

0. Exit

Choose: 2

Main › Read

--------------------------------------------

1. Search live (asks Telegram)

2. Sync the archive (everything, or one chat or topic)

3. Archive status

4. Search or export the archive

5. Prune old rows (retention)

6. Forget a scope or identity

0. Back

Choose: 1

Main › Read › Search › Pick a chat

Acting as: Sven (@sven) · account

--------------------------------------------

1. Forum groups (2)

2. Channels (2)

3. Groups (1)

4. Direct chats (1)

5. Type an ID or @username

0. Back

Choose: 1

Main › Read › Search › Pick a chat › Forum groups

Acting as: Sven (@sven) · account

--------------------------------------------

1. Team Hermes -1001000000001

2. Ops Room -1001000000002

3. Filter by name

4. Type an ID or @username

0. Back

Choose: 1

Main › Read › Search › Team Hermes

Acting as: Sven (@sven) · account

--------------------------------------------

1. Topic [all topics]

2. Contains [(anything)]

3. From [(anyone)]

4. Since [(any date)]

5. Until [(any date)]

6. Limit [(no limit)]

7. Run it (print here)

8. Export to a file

0. Back (discards)

Choose: 2

Contains (blank cancels): deploy

Main › Read › Search › Team Hermes

Acting as: Sven (@sven) · account

--------------------------------------------

1. Topic [all topics]

2. Contains [deploy]

3. From [(anyone)]

4. Since [(any date)]

5. Until [(any date)]

6. Limit [(no limit)]

7. Run it (print here)

8. Export to a file

0. Back (discards)

Choose: 6

Maximum messages (blank cancels): 20

Main › Read › Search › Team Hermes

Acting as: Sven (@sven) · account

--------------------------------------------

1. Topic [all topics]

2. Contains [deploy]

3. From [(anyone)]

4. Since [(any date)]

5. Until [(any date)]

6. Limit [20]

7. Run it (print here)

8. Export to a file

0. Back (discards)

Choose: 7

date id from text

2026-08-30 4812 sam Deploy went out at 14:02, all green

2026-08-29 4790 hermes Deploying 3.4.1 now

Main › Read › Search › Team Hermes › Done

Acting as: Sven (@sven) · account

--------------------------------------------

1. Run it again

2. Tweak it

3. Main menu

0. Exit

Choose (Enter = main menu): 2

Telegram hides the numbers everything else needs. This finds them, and does the handful of jobs the app makes tedious — searching an old thread, saving one, emptying a topic without losing the topic.

Install telegram-tools with

pippipxuv

pip install telegram-tools

pipx install telegram-tools

uv tool install telegram-tools

View on GitHub

8 commandsdiscover · search · archive · send · create · clear-messages · bots · doctor

discover: every chat, channel and forum topic, with its real ID
search: find or export messages by text, sender, date or topic
archive: keep a local copy of your chats and search it offline
send: post a message or a file into a chat or a topic
create: make a group, a channel, or a topic inside one
clear-messages: empty a forum topic without deleting the topic
bots: list the bots you own and edit their settings
doctor: check your setup, printing no secrets

discord-tools

The same idea, for your own Discord servers.

discord-tools

--------------------------------------------

1. Find IDs (servers, channels, threads)

2. Read (search live, archive, export, members)

3. Write (send, reply, edit, delete, forward, react, pin, poll)

4. Build (create, delete, structure, leave a server)

5. Clear messages

6. Manage (roles, members, invites, webhooks)

7. Watch (rules, runner, review queue)

8. Identity (profiles, my bot, set up a bot)

9. Check setup

0. Exit

Choose: 2

Main › Read

Acting as: harrybot (profile harry) · bot

--------------------------------------------

1. Search / export messages (live, one channel)

2. Server members (names and IDs)

3. Archive: sync history into the local archive

4. Archive: search / export the archive

5. Archive: status (scopes, coverage, size)

6. Archive: prune (retention, forget)

0. Back

Choose: 1

Main › Search › Pick a channel in Agency

Acting as: harrybot (profile harry) · bot · Target: Agency (1394820000000)

--------------------------------------------

1. # 🚨alerts 1394827364512

2. > 📚vault-alerts 1394829911004

3. > 🔧system-alerts 1394829911077

4. # 📰briefings 1394827364598

5. Type a channel or thread ID

0. Back

Choose: 1

Main › Search › 🚨alerts

Acting as: harrybot (profile harry) · bot · Target: Agency › 🚨alerts (1394827364512)

--------------------------------------------

1. Contains [(anything)]

2. From [(anyone)]

3. Since [(any date)]

4. Until [(any date)]

5. Limit [(no limit)]

6. Run it (print here)

7. Export to a file

0. Back (discards)

Choose: 1

Contains (blank cancels): deploy

Main › Search › 🚨alerts

Acting as: harrybot (profile harry) · bot · Target: Agency › 🚨alerts (1394827364512)

--------------------------------------------

1. Contains [deploy]

2. From [(anyone)]

3. Since [(any date)]

4. Until [(any date)]

5. Limit [(no limit)]

6. Run it (print here)

7. Export to a file

0. Back (discards)

Choose: 6

1394829911100 2026-09-05 21:40 Harry: Deploy 4.2 is out: 6 checks green, 0 rollbacks, 41s.

1394829911042 2026-09-05 15:00 Harry: Deploy queue: 3 waiting, oldest 11 minutes.

2 message(s)

Main › Search › 🚨alerts › Done

Acting as: harrybot (profile harry) · bot · Target: Agency › 🚨alerts (1394827364512)

--------------------------------------------

1. Run it again

2. Tweak it

3. Main menu

0. Exit

Choose (Enter = main menu):

Discord makes you set a bot up through a developer portal before you can do anything. This walks you through it once, then gives you the same set of jobs: IDs, members, history, sending, creating, clearing.

Install discord-tools with

pippipxuv

pip install discord-tools-cli

pipx install discord-tools-cli

uv tool install discord-tools-cli

View on GitHub

11 commandsauth · discover · members · search · archive · send · message · create · clear-messages · bot · doctor

auth: a guided walk through the Developer Portal
discover: every server, channel and thread, with its real ID
members: list a server's members and their IDs
search: find or export a channel's messages
archive: keep a local copy of the history and search it offline
send: post as the bot, after showing you the message
message: reply, edit, react, pin, forward, copy, poll, or delete a chosen few
create: make a channel, a category, or a thread
clear-messages: clear one channel or a whole server
bot: show and edit the bot's own settings
doctor: check the token, the intent and the permissions

Recently shipped