telegram-list

List Telegram groups, channels, DMs, and forum topics.

Trigger Phrases

• “list Telegram groups”
• “what groups do I have on Telegram”
• “show my Telegram channels”
• “telegram list”
• “list topics in [group]”
• “list my Telegram DMs”

Description

This skill lists all accessible Telegram groups, channels, and DMs. DMs are included by default. For groups with forum topics enabled, you can also list the individual topics.

Usage

List all groups and DMs (default):

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py

List groups only (exclude DMs):

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py --no-dms

List topics in a specific group:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py --group 1234567890

Output as JSON:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py --json

Output Format

Table Output (default)

Found 5 groups/channels:

ID              Type         Members    Topics   Name
----------------------------------------------------------------------
1234567890      supergroup   1500       Yes      My Community
9876543210      channel      5000       -        News Channel
...

Found 3 DMs:

ID              Type         Username             Name
------------------------------------------------------------
111222333       private      @alice               Alice Smith
444555666       private      -                    Bob Jones
...

JSON Output (–json)

[
  {
    "id": 1234567890,
    "name": "My Community",
    "type": "supergroup",
    "username": "mycommunity",
    "member_count": 1500,
    "has_topics": true
  }
]

Group Types

• private – 1:1 private chats
• group – Basic groups (< 200 members)
• supergroup – Upgraded groups (can have topics)
• channel – Broadcast channels

Forum Topics

Some supergroups have “forum topics” enabled, which is similar to Discord’s channel structure. When a group has topics:

• Messages are organized by topic
• Use --group GROUP_ID to see available topics
• Sync will pull messages from each topic separately

Exit Codes

• 0 – Success
• 1 – Authentication error
• 2 – Group not found or configuration error

Related Skills

• telegram-init – Initialize Telegram connection
• telegram-sync – Sync messages from groups
• telegram-read – Read synced messages