telegram-cli

Drive Telegram from a personal user account (not a bot account) via a Telethon-backed CLI — message bots and users, read history, exchange media, and run send-and-wait QA checks without opening the Telegram app.

The bundled script lives next to this file: {baseDir}/telegram-cli.py ({baseDir} = this skill's directory). Run it with python3. Telethon must be installed (pip install telethon).

Commands

target is a username (@SomeBot) or numeric Telegram ID for every command.

# Read recent history (default --limit 5)
python3 "{baseDir}/telegram-cli.py" read @SomeBot --limit 10

# Send a text message
python3 "{baseDir}/telegram-cli.py" send @SomeBot "Hello"

# Send and wait for the reply — the command for bot testing (default --wait 30s)
python3 "{baseDir}/telegram-cli.py" ask @SomeBot "What can you do?" --wait 30