# Настройка и обслуживание (/ru/docs/tg/commands-setup)

Здесь собраны команды настройки и обслуживания. Вы найдёте параметры входа, профилей, настроек, фонового сервера, локального хранилища, диагностики и подключения агента.

Вход, профили, настройки, фоновый сервер, локальное хранилище, диагностика, подключение агента и обновления.

## Общие параметры [#общие-параметры]

| Параметр | Назначение |
| --- | --- |
| `-V, --version` | показать номер версии. |
| `-v, --verbose` | подробности: -v — идентификаторы, -vv — все известные данные. По умолчанию: `0`. |
| `--json` | машиночитаемый вывод: единственное значение JSON в stdout. |
| `--agent-json` | JSON для ИИ-агента: невидимые управляющие символы показаны явно; обычный --json сохраняет текст. |
| `--jsonl` | машиночитаемый вывод: объект JSON на строку для потоковой обработки и jq. |
| `--quiet` | отключить диагностику; ошибки остаются. |
| `--trace` | журнал соединения в stderr, без содержимого сообщений. |
| `--debug` | при сбое — полная запись о нём, с причиной и стеком, вместо короткой строки. |
| `--timeout <duration>` | ограничить время всей команды: 30s, 2m, 500ms. |
| `--offline` | читать сохранённое без подключения; ошибка, если данных нет. |
| `--no-input` | не запрашивать ввод и не открывать интерактивный вход; ввод через канал остаётся доступным. |
| `--max-input-bytes <bytes>` | максимальный размер буферизованного ввода в байтах (по умолчанию: 16777216). |
| `--max-output-bytes <bytes>` | максимальный размер машинного вывода в байтах (по умолчанию: 4194304; 0 отключает ограничение). |
| `--fields <paths>` | поля элементов или объекта через запятую: id,text; сохранять пагинацию и идентификаторы операций. |
| `--brief` | найденные сообщения и письма — только ссылка, заголовок, время, отправитель и фрагмент. |
| `--full` | найденные сообщения и письма с полным текстом и всеми полями провайдера. |
| `--dry-run` | предварительно показать разобранные аргументы и разрешения перед выполнением действия. |
| `--yes` | выполнить изменение без подтверждения уровня ask. |
| `--record` | сохранить запуск: идентификаторы и время, без текста сообщений. |
| `--no-record` | не сохранять независимо от настроек. |

## Команды [#команды]

## `tg session` [#tg-session]

войти в Telegram или выйти для этого профиля

### `tg session start` [#tg-session-start]

войти по QR-коду (по умолчанию) или телефону, коду и паролю 2FA

```sh
tg session start [method] [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `method` | необязателен | способ входа: `qr`, `phone`. По умолчанию: `qr`. |

| Параметр | Назначение |
| --- | --- |
| `--app <how>` | только первый раз: способ получения приложения профиля с my.telegram.org: `browser`, `auto`. По умолчанию: `browser`. |
| `--qr-file <png>` | сохранить QR-код в PNG для передачи агентом вместо отображения. |
| `--sms` | вход по телефону: попросить код по SMS; Telegram всё равно может отказать. |

### `tg session end` [#tg-session-end]

завершить сессию профиля в Telegram и удалить её локально

**Changes something in Telegram.**

```sh
tg session end
```

## `tg setup` [#tg-setup]

настроить Telegram и подключить агента

**Changes something in Telegram.**

```sh
tg setup [options]
```

| Параметр | Назначение |
| --- | --- |
| `--agent <agent>` | установить skill для агента; в терминале спрашивает выбор, иначе не устанавливает. Варианты: `none`, `codex`, `cursor`, `claude`, `gemini`, `all`. |
| `--app <how>` | как получить ключи приложения Telegram при первом входе. Варианты: `auto`, `browser`. По умолчанию: `auto`. |
| `--method <method>` | как войти, если сессии нет. Варианты: `qr`, `phone`. По умолчанию: `qr`. |
| `--qr-file <png>` | записать временное QR-изображение входа для агента; без терминала требуются сохранённые ключи приложения. |

## `tg account` [#tg-account]

аккаунт текущей сессии

### `tg account list` [#tg-account-list]

все профили на этом компьютере и аккаунт каждого; не обращается к мессенджеру

```sh
tg account list
```

### `tg account show` [#tg-account-show]

под каким аккаунтом вошёл профиль; последние четыре цифры телефона

```sh
tg account show [options]
```

| Параметр | Назначение |
| --- | --- |
| `--show-phone` | показать полный номер телефона. |

### `tg account update` [#tg-account-update]

изменить видимые всем имя, описание или фото профиля

**Changes something in Telegram.**

```sh
tg account update [options]
```

| Параметр | Назначение |
| --- | --- |
| `--first-name <name>` | ваше имя. |
| `--last-name <name>` | ваша фамилия. |
| `--description <text>` | описание профиля. |
| `--photo <file>` | новое фото профиля: файл изображения. |

### `tg account sessions` [#tg-account-sessions]

другие сессии аккаунта; `tg session`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-session "Справочник команды: tg session") управляет только входом этого инструмента

#### `tg account sessions list` [#tg-account-sessions-list]

все подключённые устройства и приложения; ничего не завершается

```sh
tg account sessions list
```

#### `tg account sessions end` [#tg-account-sessions-end]

завершить все другие сессии, включая телефон; текущая остаётся

**Changes something in Telegram.**

```sh
tg account sessions end [options]
```

| Параметр | Назначение |
| --- | --- |
| `--others` | все сессии кроме текущей. |

## `tg models` [#tg-models]

модели, работающие на компьютере

### `tg models audio` [#tg-models-audio]

модели распознавания голосовых сообщений

#### `tg models audio list` [#tg-models-audio-list]

модели от наиболее подходящих, наличие загрузки и выбор по умолчанию

```sh
tg models audio list
```

#### `tg models audio download` [#tg-models-audio-download]

однократно скачать модель с проверкой ожидаемого sha256

```sh
tg models audio download <model>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `model` | обязателен | идентификатор модели из `models audio list`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-models-audio-list "Справочник команды: tg models audio list"). |

### `tg models text` [#tg-models-text]

модели векторизации для поиска разговоров по смыслу

#### `tg models text list` [#tg-models-text-list]

модели от наиболее подходящих, наличие загрузки и выбор по умолчанию

```sh
tg models text list
```

#### `tg models text download` [#tg-models-text-download]

однократно скачать модель с проверкой ожидаемого sha256

```sh
tg models text download <model> [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `model` | обязателен | идентификатор из `models text list`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-models-text-list "Справочник команды: tg models text list"). |

| Параметр | Назначение |
| --- | --- |
| `--accept-terms` | принять собственные лицензионные условия модели. |

#### `tg models text key` [#tg-models-text-key]

ключи API сервисов векторов и анализа

#### `tg models text key set` [#tg-models-text-key-set]

сохранить ключ через скрытый ввод или stdin, никогда аргументом

```sh
tg models text key set <provider>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `provider` | обязателен | openai, anthropic или хост сервера --base-url, требующего ключ. |

#### `tg models text key remove` [#tg-models-text-key-remove]

удалить сохранённый ключ

```sh
tg models text key remove <provider>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `provider` | обязателен | openai, anthropic или хост сервера. |

## `tg watch` [#tg-watch]

выводить новые сообщения до Ctrl-C или --timeout; оба завершают штатно

```sh
tg watch [options]
```

| Параметр | Назначение |
| --- | --- |
| `--events` | также правки, удаления и реакции; строка содержит тип события. |

## `tg serve` [#tg-serve]

поддерживать базу актуальной до остановки; запускается systemd или launchd

```sh
tg serve
```

## `tg server` [#tg-server]

`tg serve`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-serve "Справочник команды: tg serve") в фоне: запуск, остановка, перезапуск, состояние, журнал; install добавляет systemd или launchd

### `tg server start` [#tg-server-start]

запустить serve в фоне, через установленную службу, и ответить после подключения

```sh
tg server start
```

### `tg server stop` [#tg-server-stop]

остановить serve профиля, через службу, если используется

```sh
tg server stop
```

### `tg server restart` [#tg-server-restart]

остановить и запустить снова

```sh
tg server restart
```

### `tg server status` [#tg-server-status]

работает ли serve, с какого времени, кто запустил и какая служба используется

```sh
tg server status
```

### `tg server logs` [#tg-server-logs]

последние строки serve из журнала systemd или файла

```sh
tg server logs [options]
```

| Параметр | Назначение |
| --- | --- |
| `-n, --lines <n>` | количество строк. По умолчанию: `50`. |

### `tg server install` [#tg-server-install]

создать службу systemd или агент launchd профиля; ничего не запускает

```sh
tg server install
```

### `tg server uninstall` [#tg-server-uninstall]

удалить службу профиля; сначала остановите

```sh
tg server uninstall
```

## `tg store` [#tg-store]

локальная база сообщений

### `tg store status` [#tg-store-status]

по чатам: число сообщений, крайние даты, полностью сохранённые участки

```sh
tg store status [chat]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `chat` | необязателен | чат: название или его часть, идентификатор, @username или `me` для «Избранного». |

### `tg store gaps` [#tg-store-gaps]

проверить записанные внутренние пробелы охвата и явно загрузить данные для них

#### `tg store gaps plan` [#tg-store-gaps-plan]

локальный план охвата; отсутствие идентификаторов сообщений само по себе не означает нехватку истории

```sh
tg store gaps plan <chat>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `chat` | обязателен | чат: название или его часть, идентификатор, @username или `me` для «Избранного». |

#### `tg store gaps repair` [#tg-store-gaps-repair]

загрузить данные внутренних пробелов с ограничениями и перепроверить охват; никогда не удалять сообщения, которые не встретились при загрузке

```sh
tg store gaps repair <chat> [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `chat` | обязателен | чат: название или его часть, идентификатор, @username или `me` для «Избранного». |

| Параметр | Назначение |
| --- | --- |
| `--limit <n>` | общее число сообщений при этом устранении пробелов, по умолчанию 500. |
| `--max-gaps <n>` | не более указанного числа пробелов, по умолчанию 5. |
| `--repair-time <duration>` | лимит времени устранения пробелов, по умолчанию 30s. По умолчанию: `30s`. |
| `--page-size <n>` | число сообщений на страницу провайдера. |
| `--pause <duration>` | пауза между страницами провайдера. По умолчанию: `1s`. |
| `--fingerprint <hash>` | отказать, если этот ранее проверенный план охвата изменился. |
| `--catch-up` | подготовить локальный поиск после устранения пробелов; переопределяет searchCatchUp. |
| `--no-catch-up` | пропустить подготовку локального поиска после устранения пробелов. |
| `--catch-up-chunks <n>` | максимальное число подготавливаемых локальных фрагментов. |
| `--catch-up-messages <n>` | максимальное число сохранённых сообщений, читаемых для подготовки. |
| `--catch-up-time <duration>` | время подготовки в пределах оставшегося лимита устранения пробелов. |
| `--background` | устранять пробелы через существующий механизм заданий хранилища; проверять через store jobs show. |

### `tg store jobs` [#tg-store-jobs]

фоновые задания синхронизации

#### `tg store jobs list` [#tg-store-jobs-list]

задания от новых к старым

```sh
tg store jobs list [options]
```

| Параметр | Назначение |
| --- | --- |
| `--state <state>` | только задачи в этом состоянии. Одно из: `running`, `done`, `partial`, `failed`, `cancelled`, `died`. |

#### `tg store jobs show` [#tg-store-jobs-show]

задание (по умолчанию последнее) и сохранённые данные его чата

```sh
tg store jobs show [job]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `job` | необязателен | идентификатор задания из `messages sync --background`[↗](/llms.mdx/docs/ru/tg/commands-personal/content.md#tg-messages-sync "Справочник команды: tg messages sync"). |

#### `tg store jobs cancel` [#tg-store-jobs-cancel]

остановить после текущей страницы; следующая синхронизация продолжит

```sh
tg store jobs cancel <job>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `job` | обязателен | идентификатор задания. |

#### `tg store jobs retry` [#tg-store-jobs-retry]

повторить неудачное или прерванное задание как новое; синхронизация продолжается с места остановки базы

```sh
tg store jobs retry [job] [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `job` | необязателен | идентификатор задания. |

| Параметр | Назначение |
| --- | --- |
| `--failed` | каждый чат, чьё последнее задание неудачно или прервано. |

#### `tg store jobs clear` [#tg-store-jobs-clear]

забыть завершённые задания и удалить их журналы; запущенное задание сохраняется

**Изменяет данные только на этом компьютере.**

```sh
tg store jobs clear
```

### `tg store export` [#tg-store-export]

сохранённые сообщения чата от старых к новым: --jsonl — сообщение на строку, --json — один объект \{ items, page, limit, hasMore }; без запросов

```sh
tg store export [chats] [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `chats`[↗](/llms.mdx/docs/ru/tg/commands-personal/content.md#tg-chats "Справочник команды: tg chats") | необязателен | чат: название или его часть, идентификатор, @username или `me` для «Избранного»; несколько — с --to. |

| Параметр | Назначение |
| --- | --- |
| `--format <format>` | jsonl: сообщение на строку, по умолчанию с --output; markdown: переписка с дневными заголовками и цитатами ответов и пересылок. |
| `--since-time <time>` | после времени ISO 8601 или 30m / 2h / 1d назад. |
| `--output <file>` | записать JSON по строкам или переписку в новый закрытый файл. |
| `--to <dir>` | записать в этот каталог файл на каждый чат и manifest; повторный запуск добавляет только изменения. |
| `--kind <kinds>` | с --to: все сохранённые чаты этих типов через запятую: dialog, group, channel, saved. |
| `--all` | с --to: все сохранённые чаты этого аккаунта. |
| `--encrypt` | сжать и зашифровать паролем, введённым в скрытом запросе или переданным через stdin; пароль нигде не хранится — без него файл не открыть. |

### `tg store clear` [#tg-store-clear]

удалить покинутые чаты из базы вместе с сообщениями

```sh
tg store clear [options]
```

| Параметр | Назначение |
| --- | --- |
| `--left` | только покинутые этим аккаунтом чаты. |
| `--allow-dangerous` | подтвердить необратимое удаление; историю покинутого чата нельзя загрузить снова. |

### `tg store info` [#tg-store-info]

файл базы: путь, размер, структура, количество строк; без изменений

```sh
tg store info
```

### `tg store check` [#tg-store-check]

проверка целостности, поисковых индексов, диска и отстающих чатов

```sh
tg store check
```

### `tg store migrate` [#tg-store-migrate]

обновить структуру до текущей версии, затем нормализовать, проиндексировать и разобрать на основы старые сообщения и заметки

```sh
tg store migrate
```

### `tg store reindex` [#tg-store-reindex]

перестроить словесный индекс, словарь опечаток, основы слов, словесный индекс файлов и индексы заметок из сохранённых данных; ничего не теряется

```sh
tg store reindex
```

### `tg store backup` [#tg-store-backup]

скопировать работающую базу в новый файл без перезаписи

```sh
tg store backup <file> [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `file` | обязателен | новый файл. |

| Параметр | Назначение |
| --- | --- |
| `--encrypt` | сжать и зашифровать паролем, введённым в скрытом запросе или переданным через stdin; пароль нигде не хранится — без него файл не открыть. |

### `tg store restore` [#tg-store-restore]

восстановить копию вместо базы; заменяемая база сохраняется рядом

```sh
tg store restore <file>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `file` | обязателен | файл, созданный `store backup`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-store-backup "Справочник команды: tg store backup"); для файла, записанного с --encrypt, запрашивается пароль. |

### `tg store decrypt` [#tg-store-decrypt]

расшифровать файл, записанный с --encrypt, в новый файл; запрашивает пароль

```sh
tg store decrypt <file> [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `file` | обязателен | файл, созданный `store backup --encrypt`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-store-backup "Справочник команды: tg store backup") или `store export --encrypt`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-store-export "Справочник команды: tg store export"). |

| Параметр | Назначение |
| --- | --- |
| `--output <file>` | новый файл, доступный только вам. |

### `tg store repair` [#tg-store-repair]

привести каждую таблицу к виду этой сборки, ничего не удаляя: таблица неправильного вида сохраняется копией рядом с новой

```sh
tg store repair [options]
```

| Параметр | Назначение |
| --- | --- |
| `--dry-run` | показать, что будет сделано, ничего не меняя. |

### `tg store reset` [#tg-store-reset]

back the store up beside itself, then delete it and start an empty one at this build's schema; asks first, or --yes

```sh
tg store reset [options]
```

| Опция | Что делает |
| --- | --- |
| `--no-backup` | delete the store without backing it up first. |

### `tg store copies` [#tg-store-copies]

таблицы, которые `store repair`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-store-repair "Справочник команды: tg store repair") сохранил копиями

#### `tg store copies delete` [#tg-store-copies-delete]

удалить одну копию, сохранённую `store repair`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-store-repair "Справочник команды: tg store repair"), по точному имени; другие таблицы не удаляет

```sh
tg store copies delete <name>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `name` | обязателен | имя копии, как его вывел `store repair`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-store-repair "Справочник команды: tg store repair"). |

## `tg flood` [#tg-flood]

ожидания, которые Telegram попросил соблюдать этот профиль, и запрет на его запись

### `tg flood clear` [#tg-flood-clear]

забыть их, снять блокировку и ограничение частоты профиля, когда Telegram больше не ограничивает аккаунт; в Telegram ничего не меняет

```sh
tg flood clear
```

## `tg runs` [#tg-runs]

записи запусков: действия инструмента и время

### `tg runs list` [#tg-runs-list]

записи от новых к старым

```sh
tg runs list [options]
```

| Параметр | Назначение |
| --- | --- |
| `--limit <n>` | количество результатов. По умолчанию: `20`. |

### `tg runs show` [#tg-runs-show]

запуск: что это было, чем он закончился и что пошло не так; -v — все события

```sh
tg runs show <run-id>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `run-id` | обязателен | идентификатор из `tg runs list`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-runs-list "Справочник команды: tg runs list"). |

### `tg runs search` [#tg-runs-search]

search recorded diagnostic metadata and events; no message contents

```sh
tg runs search [query] [options]
```

| Аргумент | Обязательность | Что это |
| --- | --- | --- |
| `query` | необязательный | case-insensitive literal diagnostic text. |

| Опция | Что делает |
| --- | --- |
| `--status <status>` | run outcome. Одно из: `success`, `failed`, `partial`, `running`. |
| `--error-code <code>` | one stable error code. |
| `--operation <name>` | one operation, such as messages.download. |
| `--profile <name>` | one recorded profile. |
| `--since-time <time>` | runs starting on or after an ISO time or 2h / 1d ago. |
| `--limit <n>` | matches per page, at most 100. По умолчанию: `20`. |
| `--page <n>` | result page. По умолчанию: `1`. |

### `tg runs path` [#tg-runs-path]

каталог запуска

```sh
tg runs path <run-id>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `run-id` | обязателен | идентификатор из `tg runs list`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-runs-list "Справочник команды: tg runs list"). |

## `tg config` [#tg-config]

действующие настройки и источники значений

### `tg config migrate` [#tg-config-migrate]

заменить прежние настройки доступа разрешениями, сохранив действующие уровни в этом файле

**Изменяет данные только на этом компьютере.**

```sh
tg config migrate [options]
```

| Параметр | Назначение |
| --- | --- |
| `--dry-run` | показать преобразование без записи в файл. |

### `tg config show` [#tg-config-show]

профиль, существующие профили, настройки и их источники

```sh
tg config show [options]
```

| Параметр | Назначение |
| --- | --- |
| `--bot` | настройки бота этого профиля вместо личного аккаунта. |

### `tg config set` [#tg-config-set]

сохранить настройку в файл

**Изменяет данные только на этом компьютере.**

```sh
tg config set <setting> <value> [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `setting` | обязательный | одно из: limit, timeoutMs, color, senderColors, record, keepRunsForDays, readOnly, allow, permissions, sendsPerHour, requestsPerMinute, transcribeWith, speechModel, catchUpMarksRead, searchCatchUp, embeddingProvider, embeddingModel, embeddingBaseUrl, embeddingDims, analysisProvider, analysisModel, analysisBaseUrl, models, proxy, readOtherBots, updateCheck, skillHint, defaultProfile, searchStemmers.cyrillic, searchStemmers.latin, accountGroups.<name>. |
| `value` | обязателен | число, true, false или список allow, например send,reaction; для группы — tg:work,max:Alice,email:me\@x. |

| Параметр | Назначение |
| --- | --- |
| `--defaults` | общая настройка всех профилей вместо текущего. |
| `--personal` | только личные аккаунты: соответствующий раздел файла. |
| `--bot` | только боты: раздел bot файла. |

### `tg config unset` [#tg-config-unset]

удалить настройку из файла

**Изменяет данные только на этом компьютере.**

```sh
tg config unset <setting> [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `setting` | обязательный | одно из: limit, timeoutMs, color, senderColors, record, keepRunsForDays, readOnly, allow, permissions, sendsPerHour, requestsPerMinute, transcribeWith, speechModel, catchUpMarksRead, searchCatchUp, embeddingProvider, embeddingModel, embeddingBaseUrl, embeddingDims, analysisProvider, analysisModel, analysisBaseUrl, models, proxy, readOtherBots, updateCheck, skillHint, defaultProfile, searchStemmers.cyrillic, searchStemmers.latin, accountGroups.<name>. |

| Параметр | Назначение |
| --- | --- |
| `--defaults` | общая настройка всех профилей вместо текущего. |
| `--personal` | только личные аккаунты: соответствующий раздел файла. |
| `--bot` | только боты: раздел bot файла. |

## `tg doctor` [#tg-doctor]

состояние установки без подключения, кроме --online

```sh
tg doctor [options]
```

| Параметр | Назначение |
| --- | --- |
| `--online` | подключиться один раз и прочитать аккаунт; без отправки. |

### `tg doctor report` [#tg-doctor-report]

содержимое отчёта без записи

#### `tg doctor report create` [#tg-doctor-report-create]

записать отчёт в файл и показать, куда отправить

```sh
tg doctor report create [options]
```

| Параметр | Назначение |
| --- | --- |
| `--run <id>` | запуск для отчёта; по умолчанию последний неудачный. |
| `--output <file>` | путь записи; по умолчанию новый файл здесь. |

## `tg commands` [#tg-commands]

команды, параметры и коды завершения в JSON — один путь команды за вызов

### `tg commands schema` [#tg-commands-schema]

argv и схемы результатов одной команды, эффекты, разрешения и указания по повторным попыткам

```sh
tg commands schema <path>
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `path` | обязательный | один путь команды, например stats messages show. |

## `tg complete` [#tg-complete]

автодополнение: `tg complete zsh`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-complete "Справочник команды: tg complete") выводит подключаемый скрипт

```sh
tg complete [words]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `words` | необязателен | |

## `tg upgrade` [#tg-upgrade]

обновить tg установившим его менеджером пакетов; --check только проверяет

```sh
tg upgrade [options]
```

| Параметр | Назначение |
| --- | --- |
| `--check` | проверить новую версию без установки. |

## `tg mcp` [#tg-mcp]

доступ агента к профилю через MCP по stdin/stdout: `claude mcp add tg -- tg mcp`

```sh
tg mcp [options]
```

| Параметр | Назначение |
| --- | --- |
| `--permission <key=level>` | переопределить разрешение только для этого сервера; повторите для нескольких ключей. |
| `--confirm-send` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--allow-dangerous` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--allow-send` | устарел: решение принимает профиль; сохранён для запуска старых настроек. |
| `--allow-mark-read` | устарел: решение принимает профиль. |
| `--allow-delete` | устарел: решение принимает профиль. |
| `--http` | обслуживать через HTTP на 127.0.0.1 для ChatGPT и Claude в браузере, за вашим туннелем. |
| `--http-confirmation <mode>` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--port <port>` | локальный порт для --http (по умолчанию 8765). |
| `--public-url <url>` | https-адрес туннеля для браузерных приложений, например https\://<name>.ts.net. |
| `--revoke` | забыть все входы, выданные браузерным приложениям; каждому придётся войти заново. |

### `tg mcp config` [#tg-mcp-config]

вывести mcpServers для Claude Desktop, Cursor и других с полными путями; без записи

```sh
tg mcp config [options]
```

| Параметр | Назначение |
| --- | --- |
| `--permission <key=level>` | переопределить разрешение только для этого сервера; повторите для нескольких ключей. |
| `--confirm-send` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--allow-dangerous` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--allow-send` | устарел: решение принимает профиль; сохранён для запуска старых настроек. |
| `--allow-mark-read` | устарел: решение принимает профиль. |
| `--allow-delete` | устарел: решение принимает профиль. |

### `tg mcp setup` [#tg-mcp-setup]

добавить локальный MCP-сервер этого профиля в Codex или Claude Code

**Изменяет данные только на этом компьютере.**

```sh
tg mcp setup <client> [options]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `client` | обязательно | codex или claude-code. |

| Параметр | Назначение |
| --- | --- |
| `--allow-writes` | подтвердить, что профиль предоставляет инструменты изменения данных. |
| `--permission <key=level>` | переопределить разрешение только для этого сервера; повторите для нескольких ключей. |
| `--confirm-send` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--allow-dangerous` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--allow-send` | устарел: решение принимает профиль; сохранён для запуска старых настроек. |
| `--allow-mark-read` | устарел: решение принимает профиль. |
| `--allow-delete` | устарел: решение принимает профиль. |

### `tg mcp doctor` [#tg-mcp-doctor]

проверить локальное подключение MCP и список инструментов этого профиля

```sh
tg mcp doctor [options]
```

| Параметр | Назначение |
| --- | --- |
| `--permission <key=level>` | переопределить разрешение только для этого сервера; повторите для нескольких ключей. |
| `--confirm-send` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--allow-dangerous` | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
| `--allow-send` | устарел: решение принимает профиль; сохранён для запуска старых настроек. |
| `--allow-mark-read` | устарел: решение принимает профиль. |
| `--allow-delete` | устарел: решение принимает профиль. |

## `tg skill` [#tg-skill]

инструкции агенту по инструменту

### `tg skill show` [#tg-skill-show]

вывести SKILL.md; `tg skill install`[↗](/llms.mdx/docs/ru/tg/commands-setup/content.md#tg-skill-install "Справочник команды: tg skill install") устанавливает для Claude Code, Codex и Gemini CLI

```sh
tg skill show [name]
```

| Аргумент | Обязательность | Описание |
| --- | --- | --- |
| `name` | необязателен | встроенный skill для задачи: follow-ups, link-conversations. |

### `tg skill install` [#tg-skill-install]

записать SKILL.md в \~/.claude/skills/tg-cli/ (Claude Code) и \~/.agents/skills/tg-cli/ (Codex, Gemini CLI)

```sh
tg skill install [options]
```

| Параметр | Назначение |
| --- | --- |
| `--for <agents>` | агенты: `claude`, `agents`, `all`. По умолчанию: `all`. |

## Коды завершения [#коды-завершения]

Выбирайте ветвь по коду, а не по тексту: текст может измениться, код — нет.

| Код | Когда |
| --- | --- |
| `0` | успех |
| `2` | `validation_error` |
| `3` | `configuration_error` |
| `4` | `authentication_error` |
| `5` | `permission_error` |
| `6` | `not_found` |
| `7` | `confirmation_required` |
| `8` | `rate_limited` |
| `9` | `timeout` |
| `10` | `network_error` |
| `11` | `provider_error` |
| `12` | `provider_unavailable` |
| `13` | `invalid_response` |
| `14` | `outcome_unknown` |
| `130` | `cancelled` |
| `1` | остальные случаи |

`0` и только `0` означает, что операция выполнена. `14` (`outcome_unknown`) означает, что сообщение **могло**
быть отправлено: повторяйте только с тем же `--send-id`, по которому Telegram отбрасывает вторую копию.