Send, read, search, and manage Telegram messages and media via Telethon.

10|1|Updated Jun 29, 2026

Search Tags:#automation #messaging #communication #client #telegram #mtproto

Ready to run

npx skills add https://github.com/mishahanin/heading-os --skill telegram-mishahanin

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: telegram
Source: https://github.com/mishahanin/heading-os/tree/main/.claude/skills/telegram
Command: npx skills add https://github.com/mishahanin/heading-os --skill telegram-mishahanin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires telethon, python-dotenv, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill bridges the gap between your executive workflow and your personal messaging, allowing you to handle Telegram communications without leaving your command-line environment or context-switching to a mobile app.

Core Features & Use Cases

Direct Messaging: Send, read, reply to, and forward messages as your personal account, not a bot.
Media Management: Download files and photos directly into your secure data overlay or send documents from your workspace.
Search & Discovery: Quickly search message history or list unread conversations to stay on top of critical updates.

Quick Start

Use the telegram skill to read the latest messages from your conversation with John Smith.

Frequently Asked Questions about telegram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I send and read Telegram messages directly from the terminal?▼

You can send, read, and manage Telegram messages from the terminal by using a client interface that operates as your personal account over the MTProto protocol. This requires the Telethon library and valid API credentials to maintain a secure, authenticated session.

Do I need API credentials to use a Telethon client for messaging?▼

Yes, using a Telethon client for messaging requires valid API credentials to authenticate your personal account. This setup establishes a secure MTProto session, allowing the interface to send, read, and search your real-time conversations.

Can I download Telegram media and files into my workspace via command line?▼

Yes, you can download Telegram media and files directly into your secure data overlay via command line. The client interface manages file transfers from your conversations, allowing you to handle personal media without leaving your terminal environment.

How does a terminal-based Telegram client compare to using a messaging bot?▼

A terminal-based Telegram client operates as your personal account, not a bot, allowing you to manage real-time messaging, file transfers, and conversation history retrieval directly. This bridges your executive workflow with personal messaging without context-switching to a mobile app.

What is the best way to search Telegram conversation history in a command-line environment?▼

The best way to search Telegram conversation history in a command-line environment is using a full-featured client interface. It allows you to quickly search message history and list unread conversations to stay on top of critical updates.

What are the limitations of managing personal Telegram messages through a terminal client?▼

Managing personal Telegram messages through a terminal client requires the Telethon library and python-dotenv to maintain an authenticated MTProto session. It is designed for professional communication workflows, handling text, search, and media rather than serving as a bot.