tg
Telegram CLI for reading, searching, and sending messages. Use when the user asks about Telegram messages, wants to check inbox, search chats, send messages, or look up contacts and groups.
Best use case
tg is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Telegram CLI for reading, searching, and sending messages. Use when the user asks about Telegram messages, wants to check inbox, search chats, send messages, or look up contacts and groups.
Teams using tg should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/tg/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How tg Compares
| Feature / Agent | tg | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Telegram CLI for reading, searching, and sending messages. Use when the user asks about Telegram messages, wants to check inbox, search chats, send messages, or look up contacts and groups.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# Telegram CLI Fast Telegram CLI for reading, searching, and sending messages. ## When to Use Use this skill when the user: - Asks to check Telegram messages or inbox - Wants to search Telegram for a topic/keyword - Wants to send a Telegram message to someone - Asks about a Telegram group, contact, or chat - Wants to see unread messages - Needs to look up group members or admins ## Install ```bash npm install -g @cyberdrk/tg ``` Or from source: ```bash cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link ``` ## Authentication First-time setup requires API credentials from https://my.telegram.org/apps ```bash tg auth ``` ## Commands ### Reading ```bash tg inbox # Unread messages summary tg chats # List all chats tg read "ChatName" -n 50 # Read last 50 messages tg read "ChatName" --since "1h" # Messages from last hour tg read @username -n 20 # Read DM with user tg search "query" --chat "ChatName" # Search within chat tg search "query" --all # Search all chats ``` ### Writing ```bash tg send @username "message" # Send DM tg send "GroupName" "message" # Send to group tg reply "ChatName" 12345 "response" # Reply to message ID ``` ### Contacts & Groups ```bash tg contact @username # Get contact info tg members "GroupName" # List group members tg admins "GroupName" # List admins only tg groups --admin # Groups where you're admin ``` ### Status ```bash tg whoami # Show logged-in account tg check # Verify session ``` ## Output Formats All commands support `--json` for structured output suitable for processing: ```bash tg inbox --json # JSON format tg read "Chat" --json # JSON with messages array tg chats --json # JSON with chat list ``` ## Examples Check inbox: ```bash tg inbox ``` Read recent messages from a chat: ```bash tg read "MetaDAO Community" -n 20 ``` Search for a topic: ```bash tg search "futarchy" --chat "MetaDAO" ``` Send a message: ```bash tg send @username "Hello, checking in!" ``` ## Notes - Chat names can be partial matches (e.g., "MetaDAO" matches "MetaDAO Community") - Usernames must start with @ (e.g., @username) - Messages are returned in reverse chronological order (newest first) - The `--since` flag accepts formats like "1h", "30m", "7d"
Related Skills
---
name: article-factory-wechat
humanizer
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
tavily-search
Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.
baidu-search
Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.
agent-autonomy-kit
Stop waiting for prompts. Keep working.
Meeting Prep
Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.
self-improvement
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.
botlearn-healthcheck
botlearn-healthcheck — BotLearn autonomous health inspector for OpenClaw instances across 5 domains (hardware, config, security, skills, autonomy); triggers on system check, health report, diagnostics, or scheduled heartbeat inspection.
linkedin-cli
A bird-like LinkedIn CLI for searching profiles, checking messages, and summarizing your feed using session cookies.
notebooklm
Google NotebookLM 非官方 Python API 的 OpenClaw Skill。支持内容生成（播客、视频、幻灯片、测验、思维导图等）、文档管理和研究自动化。当用户需要使用 NotebookLM 生成音频概述、视频、学习材料或管理知识库时触发。
小红书长图文发布 Skill
## 概述