tgcli

Name: tgcli
Rating: 76
Author: kfastov

Telegram CLI with background sync.

When to Use

Use this skill when the user:

•Wants to read or search Telegram messages
•Needs recent updates or an inbox-style view of chats
•Asks to send a Telegram message or file
•Wants to download media or files from Telegram
•Wants to look up channels, groups, or contacts
•Needs archive/backfill sync for a chat

Install

bash

npm install -g @kfastov/tgcli

Or:

bash

brew install kfastov/tap/tgcli

Authentication

First-time setup needs Telegram API credentials from https://my.telegram.org/apps

bash

tgcli auth

Common Commands

Reading

bash

tgcli channels list --limit 20
tgcli messages list --chat @username --limit 50
tgcli messages search "query" --chat @channel --source archive
tgcli topics list --chat @channel --limit 20

Files & Media

bash

tgcli media download --chat @channel --id 12345
tgcli send file --to @channel --file ./report.pdf --caption "FYI"

Writing

bash

tgcli send text --to @username --message "Hello"

Sync & Service

bash

tgcli sync --follow
tgcli sync jobs add --chat @channel --min-date 2024-01-01T00:00:00Z
tgcli service install
tgcli service start

Contacts & Groups

bash

tgcli contacts search "alex"
tgcli groups list --query "Nha Trang"

Output Formats

All commands support --json for structured output:

bash

tgcli messages list --chat @username --limit 5 --json
tgcli channels list --limit 10 --json

Notes

•Use --source live|archive|both when listing or searching messages.
•--json is best for AI/tooling pipelines.