# Configuración y mantenimiento (/es/docs/tg/commands-setup)

Esta referencia reúne comandos de configuración y mantenimiento. Consulta opciones de acceso, perfiles, configuración, servidor en segundo plano, almacén local, diagnóstico y conexión del agente.

Acceso, perfiles, configuración, servidor en segundo plano, almacén local, diagnóstico, conexión del agente y actualizaciones.

## Opciones comunes a todos los comandos [#opciones-comunes-a-todos-los-comandos]

| Opción | Qué hace |
| --- | --- |
| `-V, --version` | muestra el número de versión. |
| `-v, --verbose` | añade detalles: -v muestra identificadores, -vv todos los datos conocidos. Valor predeterminado: `0`. |
| `--json` | salida para programas: un único valor JSON por stdout, nada más. |
| `--agent-json` | JSON para agentes de IA: muestra los controles invisibles; --json normal conserva el texto. |
| `--jsonl` | salida para programas: un objeto JSON por línea, para flujos y jq. |
| `--quiet` | oculta los mensajes de diagnóstico, pero sigue mostrando fallos. |
| `--trace` | registros de la conexión por stderr; nunca el contenido de mensajes. |
| `--debug` | ante un fallo, su registro completo —causa y pila— en lugar de la línea breve. |
| `--timeout <duration>` | detiene todo el comando después de este intervalo: 30s, 2m, 500ms. |
| `--offline` | responde desde lo guardado sin conectarse; falla si no hay datos. |
| `--no-input` | no pedir entrada ni abrir un inicio de sesión interactivo; la entrada mediante una tubería sigue disponible. |
| `--max-input-bytes <bytes>` | máximo de bytes de entrada almacenados en búfer (predeterminado: 16777216). |
| `--max-output-bytes <bytes>` | máximo de bytes de salida para máquinas (predeterminado: 4194304; 0 desactiva el límite). |
| `--fields <paths>` | campos de elementos o del objeto separados por comas: id,text; conservar la paginación y los identificadores de operaciones. |
| `--brief` | mensajes y correo encontrados solo con referencia, título, hora, remitente y fragmento. |
| `--full` | mensajes y correo encontrados con su texto completo y todos los campos del proveedor. |
| `--dry-run` | previsualizar los argumentos analizados y los permisos antes de ejecutar la acción. |
| `--yes` | omite la confirmación que el nivel ask exige antes de escribir. |
| `--record` | guarda esta ejecución: identificadores y tiempos, nunca contenido. |
| `--no-record` | no guarda la ejecución, independientemente de la configuración. |

## Comandos [#comandos]

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

inicia o cierra la sesión de Telegram de este perfil

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

inicia sesión mediante QR (predeterminado) o teléfono, código y contraseña 2FA

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `method` | opcional | método de acceso. Valores: `qr`, `phone`. Predeterminado: `qr`. |

| Opción | Qué hace |
| --- | --- |
| `--app <how>` | solo la primera vez: cómo obtener la aplicación de my.telegram.org para el perfil. Valores: `browser`, `auto`. Predeterminado: `browser`. |
| `--qr-file <png>` | guarda el QR en este PNG en lugar de dibujarlo, para que un agente pueda mostrártelo. |
| `--sms` | acceso por teléfono: pedir el código por SMS; Telegram puede rechazarlo. |

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

cierra la sesión del perfil en Telegram y elimina su archivo local

**Changes something in Telegram.**

```sh
tg session end
```

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

configura Telegram y conecta tu agente

**Changes something in Telegram.**

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

| Opción | Qué hace |
| --- | --- |
| `--agent <agent>` | instala la skill para este agente; pregunta en una terminal, de lo contrario no instala ninguna. Valores: `none`, `codex`, `cursor`, `claude`, `gemini`, `all`. |
| `--app <how>` | cómo obtener las credenciales de aplicación Telegram la primera vez. Valores: `auto`, `browser`. Por defecto: `auto`. |
| `--method <method>` | cómo iniciar sesión si no existe una. Valores: `qr`, `phone`. Por defecto: `qr`. |
| `--qr-file <png>` | guarda una imagen QR temporal para el acceso del agente; sin terminal requiere credenciales de aplicación guardadas. |

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

la cuenta conectada

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

todos los perfiles de este ordenador y sus cuentas; no consulta el servicio de mensajería

```sh
tg account list
```

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

cuenta con la que inició sesión el perfil; solo muestra las cuatro últimas cifras del teléfono

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

| Opción | Qué hace |
| --- | --- |
| `--show-phone` | muestra el número completo. |

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

cambia nombre, descripción o foto visibles de tu perfil

**Changes something in Telegram.**

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

| Opción | Qué hace |
| --- | --- |
| `--first-name <name>` | tu nombre. |
| `--last-name <name>` | tus apellidos. |
| `--description <text>` | información sobre ti. |
| `--photo <file>` | nueva foto de perfil: un archivo de imagen. |

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

otras sesiones de la cuenta; no es `tg session`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-session "Referencia del comando: tg session"), que gestiona la sesión de esta herramienta

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

todos los dispositivos y aplicaciones con sesión en esta cuenta, sin cerrar ninguno

```sh
tg account sessions list
```

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

cierra todos los demás dispositivos, incluido el móvil; conserva este

**Changes something in Telegram.**

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

| Opción | Qué hace |
| --- | --- |
| `--others` | todas las sesiones salvo esta. |

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

modelos que se ejecutan en este equipo

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

modelos para transcribir voz

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

modelos de voz, más adecuados primero, cuáles están descargados y cuál es el predeterminado

```sh
tg models audio list
```

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

descarga un modelo y verifica el sha256 esperado por esta versión

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `model` | obligatorio | identificador de modelo de `models audio list`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-models-audio-list "Referencia del comando: tg models audio list"). |

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

modelos vectoriales para buscar conversaciones por significado

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

modelos vectoriales, más adecuados primero, descargados y predeterminado

```sh
tg models text list
```

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

descarga un modelo vectorial y comprueba el sha256 esperado por la versión

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `model` | obligatorio | identificador de `models text list`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-models-text-list "Referencia del comando: tg models text list"). |

| Opción | Qué hace |
| --- | --- |
| `--accept-terms` | acepta las condiciones de licencia específicas del modelo. |

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

claves API de los proveedores de vectores y de análisis

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

guarda una clave introducida oculta o por stdin; nunca como argumento

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `provider` | obligatorio | openai, anthropic o el servidor de --base-url que requiere una clave. |

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

elimina una clave guardada

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `provider` | obligatorio | openai, anthropic o el nombre de host del servidor. |

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

imprime mensajes nuevos hasta Ctrl-C o --timeout; ambos finalizan normalmente

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

| Opción | Qué hace |
| --- | --- |
| `--events` | incluye ediciones, eliminaciones y reacciones; cada línea indica su evento. |

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

mantiene actualizado el archivo local hasta detenerlo; lo ejecutan unidades systemd o launchd

```sh
tg serve
```

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

`tg serve`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-serve "Referencia del comando: tg serve") en segundo plano: iniciar, detener, reiniciar, estado y registros; install añade una unidad systemd o launchd

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

inicia serve en segundo plano mediante la unidad si existe y responde cuando se conecta

```sh
tg server start
```

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

detiene serve de este perfil mediante su unidad, si la utiliza

```sh
tg server stop
```

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

lo detiene y vuelve a iniciarlo

```sh
tg server restart
```

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

si serve está activo para el perfil, desde cuándo, quién lo inició y unidad si existe

```sh
tg server status
```

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

últimos registros de serve, desde systemd o su archivo de registros

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

| Opción | Qué hace |
| --- | --- |
| `-n, --lines <n>` | número de líneas. Predeterminado: `50`. |

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

crea una unidad systemd o agente launchd para el perfil, sin iniciarlo

```sh
tg server install
```

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

elimina la unidad del perfil; detenla primero

```sh
tg server uninstall
```

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

archivo local de mensajes

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

por chat: cantidad guardada, más antiguo y reciente, y tramos completos

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `chat` | opcional | chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados. |

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

inspeccionar las lagunas internas de cobertura registradas y descargar explícitamente los datos que faltan

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

plan de cobertura local; los identificadores de mensajes ausentes no implican por sí solos que falte historial

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `chat` | obligatorio | chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados. |

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

descargar datos de lagunas internas con límites y volver a comprobar la cobertura; nunca eliminar los mensajes no encontrados

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `chat` | obligatorio | chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados. |

| Opción | Qué hace |
| --- | --- |
| `--limit <n>` | total de mensajes en esta reparación, 500 de forma predeterminada. |
| `--max-gaps <n>` | como máximo este número de lagunas, 5 de forma predeterminada. |
| `--repair-time <duration>` | tiempo disponible para la reparación, 30s de forma predeterminada. Predeterminado: `30s`. |
| `--page-size <n>` | mensajes por página del proveedor. |
| `--pause <duration>` | pausa entre páginas del proveedor. Predeterminado: `1s`. |
| `--fingerprint <hash>` | rechazar si este plan de cobertura previamente revisado ha cambiado. |
| `--catch-up` | preparar la búsqueda local después de reparar; anula searchCatchUp. |
| `--no-catch-up` | omitir la preparación de la búsqueda local después de reparar. |
| `--catch-up-chunks <n>` | máximo de fragmentos locales que se preparan. |
| `--catch-up-messages <n>` | máximo de mensajes almacenados que se leen para la preparación. |
| `--catch-up-time <duration>` | tiempo de preparación dentro del tiempo restante de la reparación. |
| `--background` | reparar mediante el mecanismo existente de trabajos del almacenamiento; consultar store jobs show. |

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

sincronizaciones en segundo plano

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

sincronizaciones en segundo plano, recientes primero

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

| Opción | Qué hace |
| --- | --- |
| `--state <state>` | solo las tareas en este estado. Uno de: `running`, `done`, `partial`, `failed`, `cancelled`, `died`. |

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

tarea indicada o la más reciente y datos de su chat ya guardados

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `job` | opcional | identificador que imprimió `messages sync --background`[↗](/llms.mdx/docs/es/tg/commands-personal/content.md#tg-messages-sync "Referencia del comando: tg messages sync"). |

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

detiene la tarea tras la página actual; una sincronización posterior reanuda desde ahí

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `job` | obligatorio | identificador de tarea. |

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

reintentar una tarea fallida o interrumpida como una nueva; la sincronización continúa donde se detuvo el archivo

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `job` | opcional | id de la tarea. |

| Opción | Qué hace |
| --- | --- |
| `--failed` | cada chat cuya última tarea falló o se interrumpió. |

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

olvidar las tareas terminadas y borrar sus registros; se conserva la tarea en curso

**Solo hace cambios en este equipo.**

```sh
tg store jobs clear
```

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

mensajes guardados de un chat, antiguos primero: --jsonl un mensaje por línea, --json un objeto \{ items, page, limit, hasMore }; nunca consulta el servicio

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `chats`[↗](/llms.mdx/docs/es/tg/commands-personal/content.md#tg-chats "Referencia del comando: tg chats") | opcional | chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados; varios con --to. |

| Opción | Qué hace |
| --- | --- |
| `--format <format>` | jsonl: mensaje por línea, el predeterminado con --output; markdown: transcripción por días con respuestas y reenvíos citados. |
| `--since-time <time>` | solo a partir de esta fecha ISO 8601 o intervalo anterior como 30m / 2h / 1d. |
| `--output <file>` | escribe líneas JSON o transcripción en un archivo nuevo, legible solo por ti. |
| `--to <dir>` | escribe en esta carpeta un archivo por chat y un manifiesto; al repetirlo sobre ella, solo lo que cambió desde entonces. |
| `--kind <kinds>` | con --to: todos los chats guardados de estos tipos, separados por comas: dialog, group, channel, saved. |
| `--all` | con --to: todos los chats guardados de esta cuenta. |
| `--encrypt` | comprime y cifra con una contraseña, escrita en una solicitud oculta o pasada por stdin; nunca se guarda: si la pierdes, no se puede abrir el archivo. |

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

elimina del archivo los chats abandonados y sus mensajes

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

| Opción | Qué hace |
| --- | --- |
| `--left` | chats que esta cuenta abandonó; es lo único que elimina. |
| `--allow-dangerous` | confirma la eliminación irreversible; no se pueden descargar de nuevo chats abandonados. |

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

ruta, tamaño, esquema y filas del archivo local; no cambia nada

```sh
tg store info
```

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

comprueba integridad, índices de búsqueda, disco y chats desactualizados

```sh
tg store check
```

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

actualiza el esquema a esta versión y normaliza, indexa y extrae las raíces de los mensajes y notas anteriores

```sh
tg store migrate
```

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

reconstruye el índice de palabras, su vocabulario de erratas, las raíces, el índice de palabras de los archivos y los índices de las notas a partir de lo guardado, sin perder nada

```sh
tg store reindex
```

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

copial archivo local mientras está en uso, sin sobrescribir

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `file` | obligatorio | archivo nuevo. |

| Opción | Qué hace |
| --- | --- |
| `--encrypt` | comprime y cifra con una contraseña, escrita en una solicitud oculta o pasada por stdin; nunca se guarda: si la pierdes, no se puede abrir el archivo. |

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

restaura una copia; conserva al lado el archivo sustituido, sin eliminarlo

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `file` | obligatorio | archivo creado por `store backup`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-store-backup "Referencia del comando: tg store backup"); si se escribió con --encrypt, pide su contraseña. |

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

abre un archivo escrito con --encrypt en un archivo nuevo; pide su contraseña

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `file` | obligatorio | archivo creado por `store backup --encrypt`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-store-backup "Referencia del comando: tg store backup") o `store export --encrypt`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-store-export "Referencia del comando: tg store export"). |

| Opción | Qué hace |
| --- | --- |
| `--output <file>` | archivo nuevo, legible solo por ti. |

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

adapta cada tabla a la forma de esta versión sin eliminar nada: una tabla con una forma incorrecta se conserva como copia junto a una nueva

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

| Opción | Qué hace |
| --- | --- |
| `--dry-run` | indica qué haría, sin cambiar nada. |

### `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]
```

| Opción | Qué hace |
| --- | --- |
| `--no-backup` | delete the store without backing it up first. |

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

tablas que `store repair`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-store-repair "Referencia del comando: tg store repair") conservó como copias

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

elimina una copia conservada por `store repair`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-store-repair "Referencia del comando: tg store repair"), indicada por su nombre exacto; rechaza cualquier otra tabla

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `name` | obligatorio | nombre de la copia, tal como lo mostró `store repair`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-store-repair "Referencia del comando: tg store repair"). |

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

las esperas que Telegram pidió respetar a este perfil y un bloqueo de sus escrituras

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

olvidarlos, levantar el bloqueo y la regulación del ritmo del perfil una vez que Telegram ya no limite la cuenta; no cambia nada allí

```sh
tg flood clear
```

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

ejecuciones registradas: qué hizo la herramienta y cuándo

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

ejecuciones registradas, recientes primero

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

| Opción | Qué hace |
| --- | --- |
| `--limit <n>` | cuántas mostrar. Predeterminado: `20`. |

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

una ejecución: qué fue, cómo terminó y qué falló; -v para cada evento

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `run-id` | obligatorio | identificador de `tg runs list`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-runs-list "Referencia del comando: tg runs list"). |

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

search recorded diagnostic metadata and events; no message contents

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `query` | opcional | case-insensitive literal diagnostic text. |

| Opción | Qué hace |
| --- | --- |
| `--status <status>` | run outcome. Uno de: `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. Por defecto: `20`. |
| `--page <n>` | result page. Por defecto: `1`. |

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

directorio de una ejecución

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `run-id` | obligatorio | identificador de `tg runs list`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-runs-list "Referencia del comando: tg runs list"). |

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

ajustes efectivos y origen de cada valor

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

sustituir los ajustes de acceso antiguos por permisos, conservando los niveles efectivos de este archivo

**Solo hace cambios en este equipo.**

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

| Opción | Qué hace |
| --- | --- |
| `--dry-run` | mostrar la migración sin escribir el archivo. |

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

perfil, perfiles existentes y ajustes con su origen

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

| Opción | Qué hace |
| --- | --- |
| `--bot` | ajustes del bot del perfil en lugar de los de la cuenta personal. |

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

guarda un ajuste en la configuración

**Solo hace cambios en este equipo.**

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `setting` | obligatorio | uno de: 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` | obligatorio | número, true o false; para allow, lista como send,reaction; para un grupo, tg:work,max:Alice,email:me\@x. |

| Opción | Qué hace |
| --- | --- |
| `--defaults` | cambia los valores de todos los perfiles en lugar de solo este. |
| `--personal` | solo cuentas personales, sección personal del archivo. |
| `--bot` | solo bots, sección bot del archivo. |

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

elimina un ajuste de la configuración

**Solo hace cambios en este equipo.**

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `setting` | obligatorio | uno de: 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>. |

| Opción | Qué hace |
| --- | --- |
| `--defaults` | cambia los valores de todos los perfiles en lugar de solo este. |
| `--personal` | solo cuentas personales, sección personal del archivo. |
| `--bot` | solo bots, sección bot del archivo. |

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

estado de la instalación, sin conectarse salvo con --online

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

| Opción | Qué hace |
| --- | --- |
| `--online` | también se conecta una vez y lee la cuenta, sin enviar. |

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

contenido de un informe de problema; no escribe nada

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

guarda un informe en un archivo e indica dónde enviarlo

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

| Opción | Qué hace |
| --- | --- |
| `--run <id>` | ejecución que incluir; la última fallida por defecto. |
| `--output <file>` | destino; un archivo nuevo en la carpeta actual por defecto. |

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

comandos, opciones y códigos de salida en JSON; consulta una ruta de comando por llamada

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

argv y esquemas de resultados de un comando, efectos, permisos y orientación sobre reintentos

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `path` | obligatorio | una ruta de comando, por ejemplo: stats messages show. |

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

autocompletado: `tg complete zsh`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-complete "Referencia del comando: tg complete") imprime el script que debe cargarse

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `words` | opcional | |

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

actualiza tg con su gestor de paquetes; --check solo comprueba

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

| Opción | Qué hace |
| --- | --- |
| `--check` | comprueba si hay nueva versión sin instalar nada. |

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

ofrece el perfil a un agente por MCP mediante stdin y stdout: `claude mcp add tg -- tg mcp`

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

| Opción | Qué hace |
| --- | --- |
| `--permission <key=level>` | sobrescribir un permiso solo para este servidor; repetir para más claves. |
| `--confirm-send` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-dangerous` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-send` | obsoleta: deciden los permisos del perfil; se conserva para compatibilidad. |
| `--allow-mark-read` | obsoleta: deciden los permisos del perfil. |
| `--allow-delete` | obsoleta: deciden los permisos del perfil. |
| `--http` | servir mediante HTTP en 127.0.0.1 para ChatGPT y Claude en el navegador, detrás de tu túnel. |
| `--http-confirmation <mode>` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--port <port>` | puerto local para --http (predeterminado 8765). |
| `--public-url <url>` | dirección https del túnel que usan las aplicaciones del navegador, p. ej. https\://<name>.ts.net. |
| `--revoke` | olvida todos los inicios de sesión concedidos a aplicaciones del navegador; cada una debe volver a iniciar sesión. |

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

imprime la entrada mcpServers para Claude Desktop, Cursor y otros con rutas completas, sin escribir

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

| Opción | Qué hace |
| --- | --- |
| `--permission <key=level>` | sobrescribir un permiso solo para este servidor; repetir para más claves. |
| `--confirm-send` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-dangerous` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-send` | obsoleta: deciden los permisos del perfil; se conserva para compatibilidad. |
| `--allow-mark-read` | obsoleta: deciden los permisos del perfil. |
| `--allow-delete` | obsoleta: deciden los permisos del perfil. |

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

añade el servidor MCP local de este perfil a Codex o Claude Code

**Solo hace cambios en este equipo.**

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `client` | obligatorio | codex o claude-code. |

| Opción | Qué hace |
| --- | --- |
| `--allow-writes` | confirma que este perfil ofrece herramientas de escritura. |
| `--permission <key=level>` | sobrescribir un permiso solo para este servidor; repetir para más claves. |
| `--confirm-send` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-dangerous` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-send` | obsoleta: deciden los permisos del perfil; se conserva para compatibilidad. |
| `--allow-mark-read` | obsoleta: deciden los permisos del perfil. |
| `--allow-delete` | obsoleta: deciden los permisos del perfil. |

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

comprueba la conexión inicial MCP local y la lista de herramientas de este perfil

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

| Opción | Qué hace |
| --- | --- |
| `--permission <key=level>` | sobrescribir un permiso solo para este servidor; repetir para más claves. |
| `--confirm-send` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-dangerous` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-send` | obsoleta: deciden los permisos del perfil; se conserva para compatibilidad. |
| `--allow-mark-read` | obsoleta: deciden los permisos del perfil. |
| `--allow-delete` | obsoleta: deciden los permisos del perfil. |

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

instrucciones para que un agente utilice la herramienta

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

imprime SKILL.md; `tg skill install`[↗](/llms.mdx/docs/es/tg/commands-setup/content.md#tg-skill-install "Referencia del comando: tg skill install") lo coloca donde lo buscan Claude Code, Codex y Gemini CLI

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

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `name` | opcional | skill de tarea incluida: follow-ups, link-conversations. |

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

guarda SKILL.md en \~/.claude/skills/tg-cli/ (Claude Code) y \~/.agents/skills/tg-cli/ (Codex, Gemini CLI)

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

| Opción | Qué hace |
| --- | --- |
| `--for <agents>` | agentes para los que instalar. Valores: `claude`, `agents`, `all`. Predeterminado: `all`. |

## Códigos de salida [#códigos-de-salida]

Elige la rama según el código, no según el texto: el texto puede cambiar, el código no.

| Código | Cuándo |
| --- | --- |
| `0` | éxito |
| `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` | cualquier otro caso |

`0` y solo `0` significa que la operación se completó. `14` (`outcome_unknown`) significa que un mensaje **puede**
haberse enviado: repítelo solo con el mismo `--send-id`, que Telegram usa para descartar una segunda copia.