Руководство on tgs

Профили

Mon, 01 Jan 0001 00:00:00 +0000

Профили#

tgs поддерживает несколько аккаунтов Telegram через профили — по аналогии с профилями AWS CLI. У каждого профиля своя независимая сессия, хранящаяся в отдельном файле базы данных.

Порядок определения профиля#

При запуске любой команды tgs активный профиль определяется по следующему приоритету (от высшего к низшему):

Флаг --profile, переданный команде
Переменная окружения TGS_PROFILE
Файл .tgs.yaml в текущей или родительской директории
"default" (значение по умолчанию)

Профили для отдельных директорий#

Вы можете привязать профиль к директории, создав файл .tgs.yaml. Используйте tgs profile switch для автоматического создания:

Поиск

Mon, 01 Jan 0001 00:00:00 +0000

Поиск#

tgs предоставляет четыре подкоманды поиска, которые напрямую отображаются на методы поиска MTProto в Telegram. Весь вывод — это JSON, что упрощает передачу в jq, скармливание AI-агенту или программную обработку.

Поиск в чате#

Самая частая операция: поиск сообщений в конкретном чате.

tgs search messages "docker compose" -c @devops_notes

Аргумент запроса обязателен. Флаг -c / --chat указывает, в каком чате искать. Все поддерживаемые форматы см. в разделе Резолв чатов ниже.

Несколько чатов#

Передайте несколько чатов, повторив флаг или указав значения через запятую:

Источники

Mon, 01 Jan 0001 00:00:00 +0000

Источники#

tgs sources позволяет перечислить и изучить диалоги Telegram в вашем аккаунте — каналы, супергруппы, группы, пользователей и ботов. Весь вывод в формате JSON, удобном для обработки через jq или AI-агентов.

Пайп в jq: диагностические логи ([tgs] retry: …, [tgs] FLOOD_WAIT: …) пишутся в stderr, а JSON — в stdout. При пайпе в jq глушите stderr, чтобы парсер не подавился:
tgs sources list --with-stats 2>/dev/null | jq '.sources[].title'
Избегайте 2>&1 | jq … — это смешает логи со stdout и сломает разбор JSON.