telegram-cli

Installation
SKILL.md

Telegram CLI

Use the local skill script for Telegram work on the user's personal account.

This skill exists because Telegram Bot API is the wrong tool for reading a real personal account. Use MTProto via Telethon instead.

Quick rules

  • Prefer reads first, then propose the action queue.
  • Write commands are dry-run by default and require --execute.
  • Never run any write command with --execute unless the user explicitly approved that specific action or batch first.
  • For send, always present a draft message first and ask the user for confirmation before sending.
  • Do not run send --execute unless the user explicitly approved the final recipient and text.
  • Mark-read/archive/mute are still Telegram writes; use them only after the user has approved the batch/action.
  • Do not add edit/delete/bulk export/background automation unless the user explicitly asks.
  • Treat the Telethon session like a high-privilege secret.
  • Assume unread preservation is best-effort until tested on a real chat.

Local setup

Installs
4
First Seen
Jun 9, 2026
telegram-cli — ropl-btc/agent-skills