Profile My skills Saved Collections Edit profile Submit a skill

Tg CLI

Use this skill when the user wants to interact with Telegram — sync chats, search messages, browse recent activity, export conversations, or check account status.

javimosch 76b723f 1.3 KB Updated
Coding & Dev Tools

File contents

tg-cli Plugin

Telegram CLI for local-first sync, search, export via MTProto.

Commands

Account

  • tg-cli self version — Print version
  • tg-cli self status — Check account and sync status

Chats

  • tg-cli chats list — List Telegram chats

Messages

  • tg-cli search run — Search messages by keyword
  • tg-cli recent list — List recent messages
  • tg-cli refresh run — Refresh local Telegram cache

Usage Examples

  • "Refresh my Telegram cache"
  • "Search for messages about Rust"
  • "Show recent messages from last 24 hours"
  • "List my Telegram chats"

Installation

uv tool install kabi-tg-cli

Examples

# Login and sync
tg chats
tg refresh

# Search messages
tg search "Rust" --hours 48 --yaml
tg recent --hours 24 --limit 20 --yaml

# Export
tg export "GroupName" -f yaml -o messages.yaml

# Today's messages
tg today --sync-first

Notes

  • Requires Telegram API credentials (TG_API_ID, TG_API_HASH)
  • First run prompts for phone number and verification code
  • Messages cached locally in SQLite for fast retrieval
  • Use --sync-first to refresh before querying

javimosch/supercli/tree/main/plugins/tg-cli/skills/quickstart commit 76b723f228

Browse category

Frequently asked questions

npx skillmds@latest add javimosch/tg-cli