Быстрый старт#

От нуля до первого поиска за пять команд. Предполагается, что tgs уже установлен — если нет, смотрите Установку.

1. Аутентификация#

Вход по умолчанию импортирует существующую сессию из Telegram Desktop — без номера телефона и кода:

tgs login

Другие методы (телефон + код, QR, неинтерактивный вход для AI-агентов) описаны в разделе Аутентификация.

2. Проверка аккаунта#

tgs whoami

Возвращает активный аккаунт в JSON — ваш ID, имя и username.

3. Список ваших чатов#

Посмотрите все диалоги в аккаунте — каналы, группы, пользователей, ботов:

tgs sources list

Добавьте --type channel для фильтрации по типу или --with-stats для подсчёта сообщений. Подробнее — в разделе Источники.

4. Поиск внутри чата#

tgs search messages "release" -c @durov

-c принимает username, ссылку t.me, номер телефона или числовой ID. Сужайте выдачу флагами --from, --filter и --after / --before.

5. Поиск по всему сразу#

Не знаете, в каком чате искать? Ищите во всех одновременно:

tgs search global "meeting notes"

Это базовый цикл. Каждая команда выводит JSON — передавайте его в jq или AI-агенту. Глубже — в руководстве по поиску.