English | Русский | 中文

tgs

🔍 Telegram search from your terminal

Features

• Search messages, chats, channels — everything Telegram API exposes
• Enumerate and inspect all your dialogs with tgs sources
• Works through your real Telegram account, not a bot
• JSON output by default — built for scripts and AI agents
• Multiple account profiles, like AWS CLI
• Single binary, zero dependencies — runs anywhere
• Bottleneck is Telegram API, never the app

Installation

brew install garenal1v3/tap/tgs-cli

Homebrew on macOS & Linux. Prebuilt binaries for macOS, Linux, and Windows live on the releases page.

👉 Per-OS instructions and build-from-source: installation docs.

Documentation

📖 garenal1v3.github.io/tgs-cli (coming soon)

License

GPL-3.0