telegram

Fetch Telegram messages using the Telethon-based CLI to retrieve recent messages, perform content searches across chats, and filter by chat or date. The Skill outputs results in JSON or Markdown format with metadata including message ID, sender, timestamp, and media indicators, enabling integration into workflows without manual chat navigation.

Download attachments directly from Telegram chats to a local folder using the Skill's built-in download command. Media retrieval is tracked in the output metadata, allowing you to organize and process files programmatically alongside message content.

Store Telegram API credentials and session data in ~/.telegram_dl before running commands. The Skill handles session management automatically, requiring one-time authentication to enable persistent access to chats, messages, and sending capabilities.

Send text messages or file attachments to specific chats or users using the send command with chat name and text parameters. The Skill integrates outbound messaging into automated workflows, supporting both text content and file uploads.

List all available chats with unread message counts using the list command. The output includes chat names and types, helping you identify conversation targets for fetching, searching, or sending messages without opening the Telegram app.

The Skill supports both individual and group chats, with metadata distinguishing chat type in all outputs. Commands accept chat names or IDs, allowing flexible targeting across your entire conversation history regardless of chat category.