Начало работы on tgs

Установка

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

Установка#

tgs поставляется как один статический бинарник без зависимостей. Выберите способ под вашу платформу — установленная команда в любом случае называется tgs.

Homebrew (macOS и Linux)#

Самый быстрый способ на macOS и Linux:

brew install garenal1v3/tap/tgs-cli

Команда устанавливает бинарник tgs и обновляет его через brew upgrade.

Готовые бинарники#

Скачайте архив релиза под вашу платформу со страницы релизов. Архивы называются tgs-cli_<os>_<arch>:

Платформа	OS	Arch
macOS (Apple Silicon)	`darwin`	`arm64`
macOS (Intel)	`darwin`	`amd64`
Linux	`linux`	`amd64` / `arm64`
Windows	`windows`	`amd64` / `arm64`

macOS и Linux#

# Choose your platform: OS = darwin (macOS) or linux; ARCH = arm64 or amd64
OS=darwin
ARCH=arm64

curl -L -o tgs.tar.gz \
 "https://github.com/garenal1v3/tgs-cli/releases/latest/download/tgs-cli_${OS}_${ARCH}.tar.gz"
tar -xzf tgs.tar.gz tgs
sudo mv tgs /usr/local/bin/
tgs version

Windows#

# PowerShell — ARCH = amd64 or arm64
$Arch = "amd64"
Invoke-WebRequest `
 -Uri "https://github.com/garenal1v3/tgs-cli/releases/latest/download/tgs-cli_windows_$Arch.zip" `
 -OutFile tgs.zip
Expand-Archive tgs.zip -DestinationPath .
# Move tgs.exe into a directory on your PATH, then:
.\tgs.exe version

Сборка из исходников#

Требуется Go 1.26 или новее:

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

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

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

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

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

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

tgs login

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

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

tgs whoami

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

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

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

Аутентификация

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

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

tgs подключается к Telegram через ваш реальный аккаунт по протоколу MTProto. Аутентификация нужна один раз для каждого профиля — сессия сохраняется локально и используется повторно при последующих командах.

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

Метод по умолчанию импортирует существующую сессию из Telegram Desktop:

tgs login

Или выберите другой метод:

tgs login --type code # Phone number + SMS/Telegram code
tgs login --type qr # Scan QR code from another device

Методы входа#

Импорт из Desktop (по умолчанию)#

Импортирует существующую сессию из Telegram Desktop. tgs автоматически определяет директорию tdata на macOS, Linux и Windows.