Cuenta personal

Esta referencia reúne comandos de cuenta personal. Consulta argumentos y opciones de acceso, lectura, búsqueda, archivos y envío.

Acceso, lectura, búsqueda, archivos, envío, historial y ajustes de tu cuenta.

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.
`--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.
`--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.
`--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.

`tg session`

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

`tg session start`

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

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`

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

Changes something in Telegram.

tg session end

`tg setup`

configura Telegram y conecta tu agente

Changes something in Telegram.

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`

la cuenta conectada

`tg account list`

todos los perfiles de este ordenador y sus cuentas; no consulta el mensajero

tg account list

`tg account show`

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

tg account show [options]

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

`tg account update`

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

Changes something in Telegram.

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`

otras sesiones de la cuenta; no es tg session, que gestiona la sesión de esta herramienta

`tg account sessions list`

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

tg account sessions list

`tg account sessions end`

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

Changes something in Telegram.

tg account sessions end [options]

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

`tg chats`

chats de la cuenta

`tg chats list`

chats recientes primero, incluidos los archivados

tg chats list [options]

Opción	Qué hace
`--limit <n>`	cuántos mostrar.
`--page <n>`	número de página, desde 1.
`--all`	todas las filas, sin paginar.
`--search <text>`	solo chats cuyo nombre contiene el texto; al menos 3 caracteres.
`--kind <kind>`	solo chats de este tipo: dialog, group, channel, saved.
`--unread`	solo chats con mensajes sin leer.

`tg chats events`

quién se unió, salió, fue añadido o eliminado y quién actuó, según mensajes de servicio

tg chats events <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
`--since-time <time>`	fecha ISO 8601 o intervalo anterior como 2h / 1d; hace 7 días por defecto.
`--type <names>`	solo estos tipos, separados por comas: join, leave, add, remove, create, title, pin.

`tg chats inspect`

destino de un enlace público o invitación, sin unirse

tg chats inspect <link>

Argumento	Obligatoriedad	Qué es
`link`	obligatorio	enlace público o de invitación.

`tg chats show`

un chat: tipo, pendientes, hora del último mensaje y participantes

tg chats show <chat>

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

`tg chats send-as`

en nombre de quién puede publicar esta cuenta en un chat; no cambia la elección guardada

tg chats send-as <chat>

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

`tg chats mark-read`

marca el chat como leído; la otra persona lo ve

Changes something in Telegram.

tg chats mark-read <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
`--until <message>`	solo hasta este identificador de mensaje; hasta el más reciente por defecto.
`--topic <id>`	marca como leído solo este tema del foro; no disponible en mensajeros sin temas.

`tg chats tracking`

los chats cuyas listas de miembros descarga serve a diario al almacenamiento local — chats members fetch --track añade uno

`tg chats tracking list`

cada chat seguido: desde cuándo y su último recuento de miembros

tg chats tracking list

`tg chats tracking show`

un chat: si se sigue y su recuento de miembros por día durante los últimos 30 días

tg chats tracking show <chat>

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

`tg chats tracking add`

descargar a diario la lista de miembros de este chat mientras se ejecuta serve, a partir de su siguiente ejecución

tg chats tracking add <chat>

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

`tg chats tracking remove`

dejar de descargarla a diario; se conserva el historial ya guardado

tg chats tracking remove <chat>

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

`tg chats join`

se une a grupo o canal mediante enlace; los demás ven que entraste

Changes something in Telegram.

tg chats join <link>

Argumento	Obligatoriedad	Qué es
`link`	obligatorio	enlace de invitación o público.

`tg chats leave`

sale de grupo o canal; los demás ven que saliste

Changes something in Telegram.

tg chats leave <chat>

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

`tg chats folders`

tus carpetas de chats

`tg chats folders list`

tus carpetas, en el orden de la aplicación

tg chats folders list

`tg chats folders show`

una carpeta con los nombres de sus chats

tg chats folders show <folder>

Argumento	Obligatoriedad	Qué es
`folder`	obligatorio	id de la carpeta o su nombre exacto.

`tg chats folders create`

crea una carpeta de chats

Changes something in Telegram.

tg chats folders create <title> [options]

Argumento	Obligatoriedad	Qué es
`title`	obligatorio	nombre de carpeta; la aplicación puede rechazar nombres largos.

Opción	Qué hace
`--chat <chat>`	chat que incluir, por identificador o nombre; repite la opción para añadir más.
`--include <kinds>`	todos los chats de estos tipos: contacts, non-contacts, groups, channels, bots.
`--skip <which>`	excluir los chats muted, read, archived.
`--exclude-chat <chat>`	no mostrar nunca este chat en la carpeta; repetir para varios.
`--pin <chat>`	fijar el chat arriba de la carpeta; repetir para varios.
`--emoji <emoji>`	icono de la carpeta.

`tg chats folders update`

renombra una carpeta o cambia los chats que contiene

Changes something in Telegram.

tg chats folders update <folder> [options]

Argumento	Obligatoriedad	Qué es
`folder`	obligatorio	identificador de carpeta o título exacto.

Opción	Qué hace
`--title <title>`	nuevo nombre.
`--add <chat>`	añade un chat; repite la opción para incluir más.
`--remove <chat>`	quitar un chat de ella y de sus listas de excluidos y fijados; repítelo para más chats.
`--include <kinds>`	todos los chats de tipo contacts, non-contacts, groups, channels, bots; sustituye la regla anterior, none la borra.
`--skip <which>`	excluir los chats muted, read, archived; sustituye la regla anterior, none la borra.
`--exclude-chat <chat>`	no mostrar nunca este chat en la carpeta; repetir para varios.
`--pin <chat>`	fijar el chat arriba de la carpeta; repetir para varios.
`--emoji <emoji>`	icono de la carpeta.

`tg chats folders delete`

elimina la carpeta, conservando sus chats

Changes something in Telegram.

tg chats folders delete <folder>

Argumento	Obligatoriedad	Qué es
`folder`	obligatorio	identificador de carpeta o título exacto.

`tg chats folders order`

colocar las carpetas en este orden; las que no se nombran conservan su orden después de ellas

Changes something in Telegram.

tg chats folders order <folders>

Argumento	Obligatoriedad	Qué es
`folders`	obligatorio	identificadores de carpetas o títulos exactos, la primera va primero.

`tg chats folders join`

añadir una carpeta que alguien compartió mediante un enlace; entra en todos sus chats y los demás participantes ven que te has unido

Changes something in Telegram.

tg chats folders join <link>

Argumento	Obligatoriedad	Qué es
`link`	obligatorio	el enlace de la carpeta, como t.me/addlist/….

`tg chats rules`

reglas que utiliza chats moderate, guardadas en un archivo de este perfil

`tg chats rules show`

reglas del grupo; si no existen, muestra las predeterminadas como no guardadas

tg chats rules show <chat>

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

`tg chats rules set`

cambia una regla; el primer cambio guarda todas las reglas con sus valores predeterminados

Solo hace cambios en este equipo.

tg chats rules set <chat> <key> <value>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`key`	obligatorio	uno de: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove.
`value`	obligatorio	nuevo valor; las listas se separan con comas.

`tg chats rules unset`

restablece una regla a su valor predeterminado

Solo hace cambios en este equipo.

tg chats rules unset <chat> <key>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`key`	obligatorio	uno de: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove.

`tg contacts`

personas con las que esta cuenta tiene un chat individual

`tg contacts list`

personas con las que tienes un chat individual

tg contacts list [options]

Opción	Qué hace
`--limit <n>`	cuántos mostrar.
`--page <n>`	número de página, desde 1.
`--all`	todas las filas, sin paginar.
`--order <recent\|name>`	conversación más reciente primero o por orden alfabético. Predeterminado: `recent`.
`--search <text>`	solo personas cuyo nombre, alias local o @username contiene este texto.
`--search-notes <text>`	solo personas cuyas notas privadas contienen este texto.

`tg contacts show`

una persona y los chats que compartís

tg contacts show <person> [options]

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador, @username o parte del nombre.

Opción	Qué hace
`--with-notes`	incluir tus notas privadas, sujeto al permiso contacts.notes.list.

todo lo que el servicio de mensajería informa sobre una persona —identificadores, indicadores, última conexión y cuándo se registró— y cuántos de sus mensajes guarda el almacenamiento en cada chat que compartís, el primero y el último, y los nombres y nombres de usuario anteriores que registró el almacenamiento

tg contacts profile <person> [options]

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador, @username o parte del nombre.

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

`tg contacts context`

lo que guarda el almacenamiento local sobre una persona; --chat --refresh consulta explícitamente Telegram primero

tg contacts context <person> [options]

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador, @username o parte del nombre.

Opción	Qué hace
`--limit <n>`	como máximo este número de mensajes en cada lista; 10 por defecto.
`--since-time <time>`	nada anterior a esta fecha ISO 8601 o intervalo anterior como 2h / 1d.
`--chat <chat>`	un chat por identificador o nombre; repítelo para más — después, sus mensajes más recientes en cada uno, 20 salvo que se indique --limit, abreviados salvo que se indique -v.
`--refresh`	con --chat, leer primero sus mensajes más recientes en cada chat desde el servicio de mensajería.

`tg contacts check`

si una persona parece un bot, una cuenta falsa o un spammer: su perfil, lo que escribió en el almacenamiento y las listas públicas de bloqueos (Combot Anti-Spam (CAS), lols.bot), a las que se envía su identificador — una pista, nunca un veredicto

tg contacts check <person> [options]

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador, @username o parte del nombre.

Opción	Qué hace
`--no-registries`	omitir las listas públicas de bloqueos; seguir consultando Telegram para obtener el perfil y las fotos salvo que se indique --offline.

`tg contacts link`

registra que dos personas del archivo local son la misma; el mismo nombre nunca basta

tg contacts link <person> <other>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador, @username o parte del nombre.
`other`	obligatorio	la misma persona en otro mensajero del archivo local, como :: max:Ana.

`tg contacts unlink`

deshace contacts link para una identidad: vuelve a ser una persona independiente

tg contacts unlink <person>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador, @username o parte del nombre; : para otro mensajero.

`tg contacts lookup`

quién tiene este teléfono; lo solicita o lee por stdin, nunca como argumento

tg contacts lookup

`tg contacts sync`

guarda toda la lista de contactos del servicio en el archivo local

tg contacts sync

`tg contacts alias`

un nombre visible local y privado en la cuenta seleccionada

`tg contacts alias set`

Solo hace cambios en este equipo.

tg contacts alias set <person> <alias>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio
`alias`	obligatorio

`tg contacts alias rm`

Solo hace cambios en este equipo.

tg contacts alias rm <person>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio

`tg contacts notes`

notas privadas del contacto, compartidas por las cuentas que lo ven

`tg contacts notes list`

tg contacts notes list <person>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio

`tg contacts notes show`

tg contacts notes show <person> <id>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio
`id`	obligatorio

`tg contacts notes add`

Solo hace cambios en este equipo.

tg contacts notes add <person> [options]

Argumento	Obligatoriedad	Qué es
`person`	obligatorio

Opción	Qué hace
`--file <path>`	leer el texto de la nota desde un archivo; si se omite o se indica -, leer stdin.

`tg contacts notes edit`

Solo hace cambios en este equipo.

tg contacts notes edit <person> <id> [options]

Argumento	Obligatoriedad	Qué es
`person`	obligatorio
`id`	obligatorio

Opción	Qué hace
`--file <path>`	leer el texto de la nota desde un archivo; si se omite o se indica -, leer stdin.
`--revision <number>`	la revisión que leíste antes de editar.

`tg contacts notes remove`

Solo hace cambios en este equipo.

tg contacts notes remove <person> <id>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio
`id`	obligatorio

`tg contacts add`

añade un contacto; contacts list sigue mostrando solo personas con un chat individual

Changes something in Telegram.

tg contacts add <person>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador de persona, obtenido con `contacts lookup`, o parte de un nombre conocido.

`tg contacts remove`

elimina un contacto; conserva el chat, pero puede perderse el nombre que le asignaste

Changes something in Telegram.

tg contacts remove <person>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador de persona, obtenido con `contacts lookup`, o parte de un nombre conocido.

`tg contacts block`

impide que una persona te escriba; no necesita ser contacto

Changes something in Telegram.

tg contacts block <person>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador de persona, obtenido con `contacts lookup`, o parte de un nombre conocido.

`tg contacts unblock`

permite que una persona bloqueada vuelva a escribirte

Changes something in Telegram.

tg contacts unblock <person>

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador de persona, obtenido con `contacts lookup`, o parte de un nombre conocido.

`tg contacts rename`

renombrar el contacto en la libreta de direcciones del servicio de mensajería; usa contacts alias para un nombre local privado

Changes something in Telegram.

tg contacts rename <person> <first-name> [last-name]

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	identificador de persona, obtenido con `contacts lookup`, o parte de un nombre conocido.
`first-name`	obligatorio	el nombre con el que quieres verla.
`last-name`	opcional

`tg contacts import`

carga números y añade los usuarios que el servicio reconoce

Changes something in Telegram.

tg contacts import <file>

Argumento	Obligatoriedad	Qué es
`file`	obligatorio	una persona por línea: número, coma, tabulador o punto y coma, y nombre.

`tg messages`

lee y envía mensajes

`tg messages evidence`

paquete limitado de fuentes de mensajes guardados, recientes primero

tg messages evidence <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>`	cuántos, entre 1 y 100.
`--before-id <id>`	solo mensajes anteriores a este identificador.

`tg messages list`

mensajes del chat, del más antiguo al más reciente

tg messages list <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>`	cuántos.
`--before-id <id>`	solo mensajes anteriores a este identificador.
`--before-time <time>`	solo mensajes anteriores a esta fecha ISO 8601 o intervalo anterior como 2h / 1d.
`--after-id <id>`	solo mensajes posteriores a este identificador.
`--after-time <time>`	solo mensajes posteriores a esta fecha ISO 8601 o intervalo anterior como 2h / 1d.
`--topic <id>`	solo este tema del foro; leer hacia atrás desde su mensaje más reciente o --before-id.
`--transcribe`	transcribe notas de voz pendientes mediante el servicio o un modelo local; puede tardar minutos.
`--model <id>`	modelo de voz descargado para --transcribe; `models audio list` muestra los disponibles.
`--mark-read`	también marca como leído hasta el mensaje más reciente mostrado; la otra persona lo ve.

`tg messages send`

envía texto; si omites [text], lo lee por stdin

Changes something in Telegram.

tg messages send <chat> [text] [options]

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

Opción	Qué hace
`--topic <id>`	envía a este tema de foro; no disponible en mensajeros sin temas.
`--reply-to <message>`	responde al mensaje indicado por su identificador dentro del mismo chat.
`--comment-to <post>`	comentar esta publicación del canal; el comentario va a su grupo de discusión.
`--send-as <id>`	publicar como una de las identidades que enumera `chats send-as`; obligatorio cuando el chat publica como otra identidad de forma predeterminada.
`--send-id <id>`	reintenta un envío de resultado desconocido sin arriesgar una segunda copia.
`--silent`	entrega sin notificación.
`--no-preview`	no muestra vista previa de enlaces.
`--md`	interpreta el Markdown de este mensajero; consulta la guía de formato para la sintaxis admitida.
`--file <file>`	adjunta un archivo; el texto será su leyenda.
`--photo <file>`	adjunta .jpg, .png o .webp como foto; el texto será su leyenda.
`--as-file`	envía --file como archivo descargable, incluidos vídeos.
`--voice <file>`	envía Ogg Opus como nota de voz, sin texto ni otros adjuntos.
`--allow-any-file`	permite enviar archivos incluso de carpetas ocultas, ~/.ssh o carpetas del propio CLI.
`--at-time <time>`	programa el envío en el servicio, aunque el equipo esté apagado: 2026-09-25T09:00 (hora local) o dentro de 30m, 2h, 1d.
`--spoiler`	ocultar --photo o el vídeo tras un spoiler hasta que se pulse.
`--caption-above`	mostrar el texto encima de --photo o --file, en lugar de debajo.
`--filename <name>`	el nombre que ven los demás para --file, en lugar de su nombre en el disco.
`--html`	texto HTML: , , , .

`tg messages show`

un mensaje por chat e identificador, o por localizador msg:

tg messages show <chat> [message]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados; o un localizador msg: sin identificador de mensaje posterior.
`message`	opcional	identificador del mensaje.

`tg messages context`

un mensaje y su contexto anterior y posterior, antiguos primero

tg messages context <chat> [message] [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados; o un localizador msg: sin identificador de mensaje posterior.
`message`	opcional	identificador del mensaje.

Opción	Qué hace
`--thread`	la cadena de respuestas guardada y sus respuestas en lugar de los mensajes cercanos en el tiempo; recurre a estos si no existe el grafo.
`--thread-hops <n>`	como máximo este número de vínculos desde el resultado (predeterminado: 8).
`--thread-messages <n>`	como máximo este número de mensajes en cada contexto de hilo (predeterminado: 50).
`--thread-bytes <n>`	como máximo este número de bytes de mensajes completos y vínculos en cada contexto (predeterminado: 65536).
`--thread-within <duration>`	mensajes dentro de este intervalo a ambos lados del resultado (predeterminado: 1d).
`--before-n <n>`	cuántos anteriores. Predeterminado: `5`.
`--after-n <n>`	cuántos posteriores. Predeterminado: `5`.

`tg messages download`

guarda fotos, archivos, vídeos y voz en una carpeta; con --all, los de todo el chat

tg messages download <chat> [message] [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	opcional	identificador de mensaje; se omite con --all.

Opción	Qué hace
`--output-dir <dir>`	carpeta de destino; se crea si falta. Predeterminada: `.`.
`--all`	todos los archivos del chat, recientes primero; repite para continuar.
`--pause <duration>`	con --all, pausa entre páginas para respetar límites del servicio. Predeterminada: `1s`.
`--extract`	leer las capas de texto de los archivos que esta descarga vincula al índice de contenido local.

`tg messages transcribe`

voz a texto mediante Telegram si está disponible, o un modelo local

tg messages transcribe <chat> <message> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	obligatorio	identificador de una nota de voz.

Opción	Qué hace
`--local`	usa el modelo local, nunca el servicio.
`--model <id>`	modelo descargado que utilizar; implica --local (`models audio list`).

`tg messages edit`

cambia tu mensaje; puede que la otra persona ya haya leído el anterior

Changes something in Telegram.

tg messages edit <chat> <message> [text] [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	obligatorio	identificador de tu mensaje.
`text`	opcional	texto nuevo; si lo omites, se lee por stdin.

Opción	Qué hace
`--md`	interpreta el Markdown de este mensajero; consulta la guía de formato para la sintaxis admitida.
`--html`	texto HTML: , , , .

`tg messages delete`

elimina mensajes solo para ti; con --for-everyone, para todos

Changes something in Telegram.

tg messages delete <chat> <messages> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`messages`	obligatorio	identificadores de mensajes, máximo 10.

Opción	Qué hace
`--for-everyone`	elimina para todos, no solo para ti; no se puede recuperar.
`--allow-dangerous`	omite la confirmación que el nivel ask exige antes de eliminar.

`tg messages forward`

reenvía un mensaje a otro chat

Changes something in Telegram.

tg messages forward <chat> <message> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat de origen, por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	obligatorio	identificador del mensaje.

Opción	Qué hace
`--to <chat>`	chat de destino, por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--silent`	entrega sin notificar.
`--send-as <id>`	publicar como una de las identidades que enumera `chats send-as` para el chat --to; obligatorio cuando el chat publica como otra identidad de forma predeterminada.
`--send-id <id>`	reintenta un reenvío de resultado desconocido sin arriesgar otra copia.
`--topic <id>`	reenvía a este tema de foro del chat --to.

`tg messages pin`

fija un mensaje sin aviso, salvo con --notify

Changes something in Telegram.

tg messages pin <chat> <message> [options]

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

Opción	Qué hace
`--notify`	notifica a los miembros que se fijó el mensaje.

`tg messages unpin`

deja de fijar un mensaje

Changes something in Telegram.

tg messages unpin <chat> <message>

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

`tg messages scheduled`

mensajes programados, próximos primero; se cancelan desde la aplicación

tg messages scheduled <chat>

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

`tg messages link`

un permalink cuando se admite y el locator asociado a la cuenta

tg messages link <chat> [message]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados; o un localizador msg: sin identificador de mensaje posterior.
`message`	opcional	identificador del mensaje.

`tg messages comments`

los comentarios de una publicación del canal, del más antiguo al más reciente; están en su grupo de discusión

tg messages comments <chat> <post> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	el canal: un chat por su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`post`	obligatorio	el identificador del mensaje de la publicación en el canal.

Opción	Qué hace
`--limit <n>`	cuántos.
`--before-id <id>`	solo comentarios anteriores al comentario con este identificador.

`tg messages links`

enlaces que sitúan el mensaje en su conversación y cadena de respuestas hasta el inicio

tg messages links <chat> <message>

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

`tg reactions`

reacciones a mensajes

`tg reactions add`

añade tu reacción, sustituyendo la anterior

Changes something in Telegram.

tg reactions add <chat> <message> <emoji>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	obligatorio	identificador del mensaje.
`emoji`	obligatorio	un emoji, por ejemplo 👍.

`tg reactions remove`

retira tu reacción

Changes something in Telegram.

tg reactions remove <chat> <message>

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

`tg polls`

consulta, vota, cierra tus encuestas o crea una

`tg polls show`

encuesta e identificadores de respuestas según el mensaje actual

tg polls show <chat> <message>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	obligatorio	identificador del mensaje de la encuesta.

`tg polls voters`

quién votó por qué, lo más reciente primero; no disponible en encuestas anónimas

tg polls voters <chat> <message> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	obligatorio	el identificador del mensaje que contiene la encuesta.

Opción	Qué hace
`--answer <id>`	solo quienes eligieron esta respuesta, con el ID que muestra `polls show`.
`--limit <n>`	cuántos.

`tg polls vote`

vota o retira el voto; es visible salvo en encuestas anónimas

Changes something in Telegram.

tg polls vote <chat> <message> [answers] [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	obligatorio	identificador del mensaje de la encuesta.
`answers`	opcional	identificadores de respuestas tal como los muestra `polls show`.

Opción	Qué hace
`--retract`	retira tu voto.

`tg polls close`

cierra tu encuesta; no se puede votar ni reabrir

Changes something in Telegram.

tg polls close <chat> <message>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`message`	obligatorio	identificador de tu mensaje con la encuesta.

`tg polls create`

envía una encuesta como mensaje; pública salvo con --anonymous

Changes something in Telegram.

tg polls create <chat> <question> <answers> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`question`	obligatorio	la pregunta.
`answers`	obligatorio	al menos dos respuestas.

Opción	Qué hace
`--topic <id>`	envía a este tema de foro; no disponible en mensajeros sin temas.
`--multiple`	permite elegir varias respuestas.
`--anonymous`	oculta quién votó por cada opción.
`--revote`	permite cambiar el voto.
`--silent`	envía sin notificación.
`--send-as <id>`	publicar como una de las identidades que enumera `chats send-as`; obligatorio cuando el chat publica como otra identidad de forma predeterminada.
`--send-id <id>`	reintenta crear una encuesta de resultado desconocido sin duplicarla.
`--quiz`	cuestionario: una respuesta correcta y voto definitivo.
`--correct <n>`	con --quiz: posición de la respuesta correcta, desde 1.
`--solution <text>`	con --quiz: explicación que se ve tras responder.
`--close-time <delay>`	la encuesta se cierra sola este tiempo después del envío: de 5s a 10m, como 90s o 5m.

`tg models`

modelos que se ejecutan en este equipo

`tg models audio`

modelos para transcribir voz

`tg models audio list`

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

tg models audio list

`tg models audio download`

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

tg models audio download <model>

Argumento	Obligatoriedad	Qué es
`model`	obligatorio	identificador de modelo de `models audio list`.

`tg models text`

modelos vectoriales para buscar conversaciones por significado

`tg models text list`

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

tg models text list

`tg models text download`

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

tg models text download <model> [options]

Argumento	Obligatoriedad	Qué es
`model`	obligatorio	identificador de `models text list`.

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

`tg models text key`

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

`tg models text key set`

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

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`

elimina una clave guardada

tg models text key remove <provider>

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

`tg inbox`

mensajes ajenos sin leer en todos los chats; --new muestra los recibidos desde la última revisión

tg inbox [options]

Opción	Qué hace
`--new`	lo recibido desde la revisión anterior, cada mensaje una vez; para tareas programadas.
`--since-time <time>`	lo recibido después de esta fecha ISO 8601 o intervalo anterior como 2h / 1d; conserva el punto guardado.
`--limit <n>`	máximo por chat, los más recientes.
`--all`	incluye silenciados y archivados; por defecto los omite salvo menciones o respuestas a ti.
`--kind <kinds>`	solo chats de estos tipos, separados por comas: dialog, group, channel, saved.
`--transcribe`	transcribe notas de voz pendientes mediante el servicio o un modelo local; puede tardar minutos.
`--model <id>`	modelo de voz descargado para --transcribe; `models audio list` muestra los disponibles.
`--mark-read`	además marca como leído cada chat mostrado, hasta el mensaje más reciente mostrado; la otra persona lo ve.
`--no-mark-read`	no lo hace, diga lo que diga el ajuste catchUpMarksRead.

`tg review`

mensajes, incluidos los tuyos, en chats con actividad desde un momento; para revisar compromisos

tg review [options]

Opción	Qué hace
`--since-time <time>`	punto donde terminó la revisión anterior, en ISO 8601 o intervalo anterior como 2h / 1d; últimos 3 días por defecto.
`--chat <chat>`	solo este chat, por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--kind <kinds>`	solo chats de estos tipos, separados por comas: dialog, group, channel, saved.
`--unanswered [duration]`	solo preguntas para ti o administradores sin respuesta y anteriores a este intervalo: 4h, 1d; 24h por defecto.
`--all`	incluye silenciados y archivados; por defecto los omite salvo menciones o respuestas a ti.
`--transcribe`	transcribe notas de voz pendientes mediante el servicio o un modelo local; puede tardar minutos.
`--model <id>`	modelo de voz descargado para --transcribe; `models audio list` muestra los disponibles.
`--new`	lo que cambió desde el último `review --new`, con un punto por chat; para tareas programadas.
`--mark-read`	además marca como leído cada chat mostrado, hasta el mensaje más reciente mostrado; la otra persona lo ve.
`--no-mark-read`	no lo hace, diga lo que diga el ajuste catchUpMarksRead.

`tg topics`

temas de un grupo de foro

`tg topics list`

temas del foro por actividad reciente

tg topics list <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>`	cuántos mostrar.
`--page <n>`	número de página, desde 1.
`--all`	todas las filas, sin paginar.

`tg topics show`

un tema de foro: su título, su estado y su última actividad

tg topics show <chat> <topic>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`topic`	obligatorio	el identificador del tema, de `topics list`.

`tg topics enable`

activa temas de foro; solo el propietario, con conversión explícita para un grupo básico

Changes something in Telegram.

tg topics enable <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
`--upgrade`	convierte primero un grupo básico en supergrupo; cambia el identificador del chat.

`tg topics create`

crea un tema con nombre en un foro existente; nunca activa ni convierte un grupo implícitamente

Changes something in Telegram.

tg topics create <chat> <title> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`title`	obligatorio	el título del tema, hasta 128 bytes UTF-8.

Opción	Qué hace
`--send-id <id>`	identifica este intento de creación; rechaza un identificador ya enviado o de resultado desconocido.

`tg topics edit`

renombrar, cerrar o reabrir un tema del foro

Changes something in Telegram.

tg topics edit <chat> <topic> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`topic`	obligatorio	el identificador del tema de `topics list`.

Opción	Qué hace
`--title <title>`	el nuevo título, como máximo 128 bytes UTF-8.
`--closed <on\|off>`	on cierra el tema a nuevos mensajes; off lo vuelve a abrir.
`--pinned <on\|off>`	on fija el tema al principio de la lista; off lo desfija.
`--hidden <on\|off>`	on oculta el tema General de la lista de temas; off lo muestra.

`tg topics delete`

eliminar un tema del foro y todos sus mensajes para todos; no se puede deshacer

Changes something in Telegram.

tg topics delete <chat> <topic> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`topic`	obligatorio	el identificador del tema de `topics list`.

Opción	Qué hace
`--allow-dangerous`	omite la confirmación que el nivel ask exige antes de eliminar.

`tg topics order`

colocar los temas fijados en este orden; no fija ni desfija ninguno

Changes something in Telegram.

tg topics order <chat> <topic>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`topic`	obligatorio	los identificadores de los temas fijados, del primero al último.

`tg watch`

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

tg watch [options]

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

`tg serve`

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

tg serve

`tg server`

tg serve en segundo plano: iniciar, detener, reiniciar, estado y registros; install añade una unidad systemd o launchd

`tg server start`

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

tg server start

`tg server stop`

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

tg server stop

`tg server restart`

lo detiene y vuelve a iniciarlo

tg server restart

`tg server status`

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

tg server status

`tg server logs`

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

tg server logs [options]

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

`tg server install`

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

tg server install

`tg server uninstall`

elimina la unidad del perfil; detenla primero

tg server uninstall

`tg store`

archivo local de mensajes

`tg store status`

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

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 fetch`

descargar el historial de un chat al almacenamiento local, primero los mensajes más recientes; ejecutar de nuevo para continuar; --all descarga todos los chats

tg store fetch [chat] [options]

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

Opción	Qué hace
`--all`	todos los chats, primero los activos más recientemente — lo que necesita la búsqueda; los últimos 90d salvo que se indique --since-time o --last.
`--limit <n>`	como máximo este número de mensajes en esta ejecución, por chat con --all; 1000 si no se indica.
`--page-size <n>`	mensajes por petición; 100 si se omite.
`--pause <duration>`	pausa entre páginas para respetar límites. Predeterminada: `1s`.
`--since-time <time>`	se detiene al llegar a mensajes anteriores al momento indicado: ISO 8601 o 2h / 1d atrás.
`--last <n>`	se detiene cuando tiene guardados los n mensajes más recientes.
`--catch-up`	preparar la búsqueda local después de descargar; anula searchCatchUp.
`--no-catch-up`	omitir la preparación local después de esta descarga.
`--catch-up-chunks <n>`	como máximo este número de fragmentos de vectores locales.
`--catch-up-messages <n>`	omitir una reconstrucción del grafo con más mensajes que este número.
`--catch-up-time <duration>`	tiempo disponible para la preparación local, 30s de forma predeterminada.
`--background`	ejecuta como tarea que continúa al finalizar el comando; consúltala con `store jobs show`.
`--estimate`	solo estima mensajes, peticiones y minutos pendientes usando el archivo local, sin peticiones.

`tg store gaps`

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

`tg store gaps plan`

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

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`

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

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`

descargas en segundo plano

`tg store jobs list`

descargas en segundo plano, recientes primero

tg store jobs list [options]

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

`tg store jobs show`

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

tg store jobs show [job]

Argumento	Obligatoriedad	Qué es
`job`	opcional	identificador que imprimió `store fetch --background`.

`tg store jobs cancel`

detiene la tarea tras la página actual; una descarga posterior reanuda desde ahí

tg store jobs cancel <job>

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

`tg store jobs retry`

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

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`

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

Solo hace cambios en este equipo.

tg store jobs clear

`tg store export`

mensajes guardados de un chat en líneas JSON, antiguos primero; nunca consulta el servicio

tg store export [chats] [options]

Argumento	Obligatoriedad	Qué es
`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 (predeterminado): mensaje por línea; 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`

elimina del archivo los chats abandonados y sus mensajes

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`

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

tg store info

`tg store check`

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

tg store check

`tg store migrate`

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

tg store migrate

`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

tg store reindex

`tg store backup`

copia el archivo local mientras está en uso, sin sobrescribir

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`

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

tg store restore <file>

Argumento	Obligatoriedad	Qué es
`file`	obligatorio	archivo creado por `store backup`; si se escribió con --encrypt, pide su contraseña.

`tg store decrypt`

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

tg store decrypt <file> [options]

Argumento	Obligatoriedad	Qué es
`file`	obligatorio	archivo creado por `store backup --encrypt` o `store export --encrypt`.

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

`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

tg store repair [options]

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

`tg store copies`

tablas que store repair conservó como copias

`tg store copies delete`

elimina una copia conservada por store repair, indicada por su nombre exacto; rechaza cualquier otra tabla

tg store copies delete <name>

Argumento	Obligatoriedad	Qué es
`name`	obligatorio	nombre de la copia, tal como lo mostró `store repair`.

`tg conversations`

conversaciones dentro de un chat, identificadas por respuestas, menciones y turnos de los mensajes guardados

`tg conversations build`

identifica conversaciones en el archivo local, sustituyendo el análisis anterior; sin --chat, cada chat que cambió desde su análisis y cada grupo nunca analizado; nunca consulta el servicio

tg conversations build [options]

Opción	Qué hace
`--chat <chat>`	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--analyze`	vincula lotes con el proveedor de análisis configurado; requiere --chat y recuerda el consentimiento para este chat y proveedor.
`--provider <provider>`	análisis: agent, openai o anthropic.
`--model <model>`	modelo de análisis; tiene prioridad sobre analysisModel.
`--base-url <url>`	dirección de la API de análisis; tiene prioridad sobre analysisBaseUrl.
`--size <n>`	mensajes de respuesta del análisis por lote, 10–200; 50 por defecto.
`--max-tokens <n>`	límite de tokens de entrada y salida reservados por ejecución; 100000 por defecto.
`--max-chats <n>`	como máximo este número de chats en una ejecución; 20 por defecto.

`tg conversations list`

conversaciones recientes primero: fecha, mensajes y participantes

tg conversations list [options]

Opción	Qué hace
`--chat <chat>`	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--since-time <time>`	solo iniciadas a partir de esta fecha ISO 8601 o intervalo anterior como 30m / 2h / 1d.
`--limit <n>`	cuántos.

`tg conversations show`

mensajes de una conversación, antiguos primero, por identificador o por un mensaje que contiene

tg conversations show <conversation> [message]

Argumento	Obligatoriedad	Qué es
`conversation`	obligatorio	identificador de `conversations list` o chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados, seguido de un mensaje.
`message`	opcional	identificador de mensaje del chat; muestra la conversación que lo contiene.

las conversaciones más próximas en significado a la que contiene un mensaje, en todos los chats analizados, mejores primero; usa los vectores guardados por conversations embed; no ejecuta ningún modelo

tg conversations related <chat> <message> [options]

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

Opción	Qué hace
`--limit <n>`	cuántos.
`--model <model>`	local: identificador de `models text list` (predeterminado: e5-small); remoto: modelo del proveedor.
`--provider <provider>`	proveedor de vectores: local u openai; las opciones tienen prioridad sobre los ajustes del perfil.
`--base-url <url>`	servidor compatible con /v1/embeddings de OpenAI: Gemini, Jina, Ollama o LM Studio local.
`--dims <n>`	remoto: tamaño vectorial; necesario con --base-url y reduce el de modelos OpenAI.

`tg conversations status`

lo actualizadas que están las conversaciones y los vectores de cada chat analizado: mensajes que el análisis no ha visto, fragmentos con vector actual, desactualizado o ausente

tg conversations status [options]

Opción	Qué hace
`--chat <chat>`	solo este chat, por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--model <model>`	local: identificador de `models text list` (predeterminado: e5-small); remoto: modelo del proveedor.
`--provider <provider>`	proveedor de vectores: local u openai; las opciones tienen prioridad sobre los ajustes del perfil.
`--base-url <url>`	servidor compatible con /v1/embeddings de OpenAI: Gemini, Jina, Ollama o LM Studio local.
`--dims <n>`	remoto: tamaño vectorial; necesario con --base-url y reduce el de modelos OpenAI.

`tg conversations batches`

ventanas de mensajes para que tu agente identifique a qué mensaje anterior responde cada uno

`tg conversations batches status`

mensajes pendientes de vincular, número de lotes y cantidad de texto

tg conversations batches status [options]

Opción	Qué hace
`--chat <chat>`	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--size <n>`	mensajes que vincular por lote, 10–200; 50 por defecto.

`tg conversations batches next`

siguiente ventana con contexto previo; el texto solo se imprime por stdout

tg conversations batches next [options]

Opción	Qué hace
`--chat <chat>`	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--size <n>`	mensajes que vincular por lote, 10–200; 50 por defecto.

`tg conversations links`

respuestas de tu agente: a qué mensaje anterior responde cada mensaje del lote

`tg conversations links add`

guarda la respuesta del agente desde JSON por stdin: { "model", "answers": [{ "message", "parent", "confidence" }] }; operación completa o nada

tg conversations links add [options]

Opción	Qué hace
`--batch <id>`	identificador de lote que imprimió `conversations batches next`.

`tg conversations links clear`

elimina respuestas del agente de un chat o un modelo, sin tocar mensajes

tg conversations links clear [options]

Opción	Qué hace
`--chat <chat>`	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--model <model>`	solo respuestas de este modelo.

`tg conversations consents`

permisos de análisis recordados para los chats de esta cuenta y las direcciones de los proveedores

`tg conversations consents list`

tg conversations consents list

`tg conversations consents revoke`

tg conversations consents revoke [options]

Opción	Qué hace
`--chat <chat>`	revoca solo los consentimientos de este chat; por defecto, todos los chats.
`--provider <identity>`	identidad exacta del proveedor según consents list; por defecto, todos los proveedores.

`tg conversations embed`

calcula vectores de cada fragmento de conversaciones para búsqueda semántica, localmente o con --provider y tu clave; puede reanudarse; sin --chat, cada chat analizado con fragmentos pendientes, solo en este equipo

tg conversations embed [options]

Opción	Qué hace
`--chat <chat>`	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--model <model>`	local: identificador de `models text list` (predeterminado: e5-small); remoto: modelo del proveedor.
`--provider <provider>`	proveedor de vectores: local u openai; las opciones tienen prioridad sobre los ajustes del perfil.
`--base-url <url>`	servidor compatible con /v1/embeddings de OpenAI: Gemini, Jina, Ollama o LM Studio local.
`--dims <n>`	remoto: tamaño vectorial; necesario con --base-url y reduce el de modelos OpenAI.
`--workers <n>`	local: sesiones paralelas, cada una con su copia del modelo (~0,7 GB por copia).
`--threads <n>`	local: hilos totales (predeterminado: min(8, núcleos)).
`--concurrency <n>`	remoto: peticiones simultáneas (predeterminado: 4).
`--max-tokens <n>`	remoto: rechaza una ejecución que pueda enviar más tokens que este límite.
`--max-chats <n>`	como máximo este número de chats en una ejecución; 20 por defecto.
`--max-chunks <n>`	como máximo este número de fragmentos con vector calculado en una ejecución; 2000 por defecto, y sin límite con --chat.

`tg conversations embed status`

fragmentos con vectores, pendientes y coste de los pendientes

tg conversations embed status [options]

Opción	Qué hace
`--chat <chat>`	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--model <model>`	local: identificador de `models text list` (predeterminado: e5-small); remoto: modelo del proveedor.
`--provider <provider>`	proveedor de vectores: local u openai; las opciones tienen prioridad sobre los ajustes del perfil.
`--base-url <url>`	servidor compatible con /v1/embeddings de OpenAI: Gemini, Jina, Ollama o LM Studio local.
`--dims <n>`	remoto: tamaño vectorial; necesario con --base-url y reduce el de modelos OpenAI.

`tg conversations embed clear`

elimina vectores de un chat o modelo, sin tocar mensajes ni conversaciones

tg conversations embed clear [options]

Opción	Qué hace
`--chat <chat>`	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--model <model>`	local: identificador de `models text list` (predeterminado: e5-small); remoto: modelo del proveedor.
`--provider <provider>`	proveedor de vectores: local u openai; las opciones tienen prioridad sobre los ajustes del perfil.
`--base-url <url>`	servidor compatible con /v1/embeddings de OpenAI: Gemini, Jina, Ollama o LM Studio local.
`--dims <n>`	remoto: tamaño vectorial; necesario con --base-url y reduce el de modelos OpenAI.

`tg attachments`

los archivos de los mensajes guardados: su texto en el archivo local, para content: en una búsqueda

`tg attachments extract`

guardar el texto de archivos descargados — texto, capas de texto PDF/DOCX, ODT/ODS/XLSX/PPTX/EPUB — en el almacén local para buscar con content:

tg attachments extract [options]

Opción	Qué hace
`--chat <chat>`	solo los archivos de este chat; chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--from-dir <dir>`	asociar archivos de este directorio sin recorrer subdirectorios; requiere --chat.
`--cursor <cursor>`	continuar desde el cursor devuelto por una extracción con límites.
`--download`	primero guarda en --output-dir, desde el servicio, los archivos que todavía no se han descargado.
`--output-dir <dir>`	con --download, dónde guardarlos; se crea si no existe.
`--limit <n>`	lee como máximo este número de archivos; vuelve a ejecutarlo para continuar.
`--ocr`	llamar explícitamente a models.ocr para extraer texto en lotes de imágenes y PDF escaneados.
`--concurrency <n>`	remoto: peticiones simultáneas (predeterminado: 4).

`tg attachments list`

archivos de los mensajes guardados, dónde se guardó cada uno y si se conserva su texto; nunca el texto

tg attachments list [options]

Opción	Qué hace
`--chat <chat>`	solo los archivos de este chat; chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--needs-text`	solo los archivos guardados aquí cuyo texto nadie tiene todavía: lo que un agente lee y devuelve.
`--limit <n>`	cuántos mostrar.
`--page <n>`	número de página, desde 1.
`--all`	todas las filas, sin paginar.

`tg attachments show`

leer una porción limitada de un adjunto conservado; JSON incluye bytes en base64

tg attachments show <chat> [message] [options]

Argumento	Obligatoriedad	Qué es
`chat`	required	chat: título o parte, ID, @username, o `me` para Mensajes guardados; o solo una ubicación msg:.
`message`	opcional	identificador del mensaje.

Opción	Qué hace
`--attachment <n>`	posición del archivo desde 1; obligatoria si hay varios archivos.
`--page <n>`	renderiza una página del PDF como PNG, desde 1; unpdf/canvas opcionales, sin OCR.
`--offset-bytes <n>`	desplazamiento en bytes desde 0.
`--chunk-bytes <n>`	bytes que devolver, 1–1048576 (por defecto524288).
`--if-sha256 <hash>`	exigir el SHA-256 del archivo completo de la porción anterior.

`tg attachments text`

el texto de un archivo, tal como lo leyó un agente

`tg attachments text set`

guarda el texto que un agente leyó de un archivo (un escaneo, una foto) para que content: lo encuentre; no se envía nada

tg attachments text set <chat> [message] [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados; o un localizador msg: sin identificador de mensaje posterior.
`message`	opcional	identificador del mensaje.

Opción	Qué hace
`--attachment <n>`	qué archivo del mensaje, desde 1; necesario si tiene más de uno.
`--text-file <path>`	lee el texto de este archivo; - o nada lee stdin.

`tg tags`

tus propias etiquetas en chats, personas y mensajes, guardadas en el archivo local y nunca enviadas; tag: en una búsqueda las encuentra

`tg tags auto`

generar etiquetas locales de grupos y canales a partir de metadatos en caché mediante reglas de palabras clave

Solo hace cambios en este equipo.

tg tags auto [options]

Opción	Qué hace
`--chat <chat>`	un grupo o canal almacenado; repetir para seleccionar varios. Predeterminado: ``.
`--limit <number>`	procesar como máximo el número indicado de chats, de 1 a 500. Predeterminado: `50`.
`--refresh-metadata`	leer las descripciones actuales del servicio de mensajería antes de clasificar.
`--dry-run`	previsualizar la clasificación a partir de la caché sin modificar el almacenamiento.

`tg tags add`

pone etiquetas a un chat, una persona o un mensaje

Solo hace cambios en este equipo.

tg tags add <tag> [options]

Argumento	Obligatoriedad	Qué es
`tag`	obligatorio	una o varias etiquetas: de 1 a 32 letras a–z, cifras y guiones; las mayúsculas se pasan a minúsculas.

Opción	Qué hace
`--chat <chat>`	el chat que etiquetar, o el chat de --message; chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--contact <person>`	la persona que etiquetar: identificador, @username o nombre, tal como la conoce el archivo local.
`--message <message>`	el mensaje que etiquetar: su identificador en --chat, o un localizador msg: solo.

`tg tags remove`

quita etiquetas de un chat, una persona o un mensaje

Solo hace cambios en este equipo.

tg tags remove <tag> [options]

Argumento	Obligatoriedad	Qué es
`tag`	obligatorio	una o varias etiquetas: de 1 a 32 letras a–z, cifras y guiones; las mayúsculas se pasan a minúsculas.

Opción	Qué hace
`--chat <chat>`	el chat del que quitar etiquetas, o el chat de --message; chat por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--contact <person>`	la persona de la que quitar etiquetas: identificador, @username o nombre, tal como la conoce el archivo local.
`--message <message>`	el mensaje del que quitar etiquetas: su identificador en --chat, o un localizador msg: solo.
`--source <manual\|auto>`	eliminar solo la atribución a este origen.

`tg tags list`

lo etiquetado: los chats y mensajes de esta cuenta, y las personas de su mensajero

tg tags list [options]

Opción	Qué hace
`--tag <tag>`	solo esta etiqueta.
`--source <manual\|auto>`	solo etiquetas atribuidas a este origen.
`--type <names>`	solo lo etiquetado de este tipo: chat, contact o message.

`tg metadata`

descripciones de grupos y canales en caché para las etiquetas automáticas locales

`tg metadata get`

tg metadata get [options]

Opción	Qué hace
`--chat <chat>`	un chat almacenado.

`tg metadata refresh`

Solo hace cambios en este equipo.

tg metadata refresh [options]

Opción	Qué hace
`--chat <chat>`	un grupo o canal almacenado; repetir para varios. Predeterminado: ``.
`--only-missing`	solo chats sin metadatos; sin --chat, todos los grupos y canales guardados.
`--limit <number>`	procesar como máximo el número indicado de chats, de 1 a 500. Predeterminado: `50`.

`tg stats`

estadísticas sobre mensajes, chats y sus autores

`tg stats messages`

estadísticas de mensajes del almacenamiento local

`tg stats messages show`

cuántos mensajes guardados coinciden, por chat, remitente, día u hora; solo el archivo local; opcionalmente descarga mensajes nuevos con --sync-first

tg stats messages show [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	consulta estricta de Lucene, como en search messages; sin consulta cuenta todos los mensajes guardados; con --saved, palabras adicionales unidas con AND.

Opción	Qué hace
`--sync-first`	primero descarga los mensajes nuevos dentro de los límites de chats, tiempo y mensajes.
`--max-chats <n>`	actualiza como máximo este número de chats (predeterminado: 5).
`--sync-time <duration>`	deja de descargar tras este tiempo (predeterminado: 30s).
`--max-messages <n>`	descarga como máximo este número de mensajes en total (predeterminado: 500).
`--by <chat\|sender\|day\|hour>`	por qué contar (predeterminado: chat).
`--chat <chat>`	solo este chat, igual que chat: en la consulta; título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	todas las cuentas de este servicio guardadas, personal, bots o all; igual que in: en la consulta.
`--limit <n>`	cuántas filas.
`--timezone <zone>`	zona horaria IANA para los días y horas del calendario.
`--exact`	las palabras sin campo y las frases entre comillas coinciden solo en su forma exacta, como exact:word; text: sigue admitiendo todas las formas.
`--saved <name\|id>`	cuenta lo que coincide con una búsqueda guardada o una ejecución anterior; las opciones escritas aquí sustituyen a las suyas.

`tg stats messages counters`

observaciones por contador y actualización remota limitada

`tg stats messages counters show`

mostrar valores de contadores guardados y frescura de sus observaciones

tg stats messages counters show [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	optional	consulta Lucene estricta sobre mensajes guardados.

Opción	Qué hace
`--chat <chat>`	solo este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	cuentas conectadas de este mensajero; la actualización usa la activa.
`--exact`	las palabras sin operadores coinciden por forma exacta.
`--timezone <zone>`	zona horaria IANA para fechas de consulta.
`--selection <json>`	selección fija de objetivos de counters show; incompatible con consulta y ámbito.
`--counters <names>`	campos distintos views,reactions,comments; los tres por defecto.
`--limit <n>`	mensajes, 1–100; 20 por defecto.
`--max-age <duration>`	edad máxima de una observación reciente; 24h por defecto.

`tg stats messages counters refresh`

leer contadores autorizados de un número limitado de mensajes y actualizar sus observaciones locales

Solo hace cambios en este equipo.

tg stats messages counters refresh [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	optional	consulta Lucene estricta sobre mensajes guardados.

Opción	Qué hace
`--chat <chat>`	solo este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	cuentas conectadas de este mensajero; la actualización usa la activa.
`--exact`	las palabras sin operadores coinciden por forma exacta.
`--timezone <zone>`	zona horaria IANA para fechas de consulta.
`--selection <json>`	selección fija de objetivos de counters show; incompatible con consulta y ámbito.
`--counters <names>`	campos distintos views,reactions,comments; los tres por defecto.
`--limit <n>`	mensajes, 1–100; 20 por defecto.
`--max-messages <n>`	máximo de mensajes que actualizar, 1–100.
`--sync-time <duration>`	tiempo de actualización remota; 30s por defecto, máximo 5m.
`--dry-run`	mostrar objetivos guardados exactos y contadores admitidos sin conectar.

`tg stats messages unanswered`

preguntas detectadas más antiguas sin una respuesta directa válida observada

tg stats messages unanswered [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	una consulta Lucene estricta; si se omite, selecciona todos los mensajes almacenados.

Opción	Qué hace
`--chat <chat>`	solo este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	todas las cuentas disponibles de este servicio de mensajería; personal, bots o all.
`--exact`	las palabras sin campo coinciden en su forma exacta en lugar de por su raíz.
`--saved <name\|id>`	ejecutar un informe guardado de este tipo; las opciones indicadas sustituyen las guardadas.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.
`--limit <n>`	filas del informe, 1–100; 20 por defecto.
`--answerer <person>`	nombre guardado, alias, @username, ID o person:provider/account/id; los nombres ambiguos requieren elegir; repetir para varias.
`--older-than <duration>`	edad mínima de una pregunta sin respuesta válida observada.

`tg stats messages discussion`

publicaciones vistas con poca conversación guardada

tg stats messages discussion [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	una consulta Lucene estricta; si se omite, selecciona todos los mensajes almacenados.

Opción	Qué hace
`--chat <chat>`	solo este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	todas las cuentas disponibles de este servicio de mensajería; personal, bots o all.
`--exact`	las palabras sin campo coinciden en su forma exacta en lugar de por su raíz.
`--saved <name\|id>`	ejecutar un informe guardado de este tipo; las opciones indicadas sustituyen las guardadas.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.
`--limit <n>`	filas del informe, 1–100; 20 por defecto.
`--min-views <n>`	mínimo de vistas acumuladas conocidas.
`--max-replies <n>`	máximo de respuestas observadas en la conversación.

`tg stats messages top`

clasificar mensajes guardados por métrica o puntuación explicable; cada contador indica la frescura de su observación

tg stats messages top [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	una consulta Lucene estricta; si se omite, selecciona todos los mensajes almacenados.

Opción	Qué hace
`--sync-first`	primero descarga los mensajes nuevos dentro de los límites de chats, tiempo y mensajes.
`--max-chats <n>`	actualiza como máximo este número de chats (predeterminado: 5).
`--sync-time <duration>`	deja de descargar tras este tiempo (predeterminado: 30s).
`--max-messages <n>`	descarga como máximo este número de mensajes en total (predeterminado: 500).
`--measure <name>`	métrica de clasificación; no se combina con score ni weights. Uno de: `views`, `reactions`, `forwards`, `comments`, `replies`, `thread-size`.
`--score <preset>`	helpful/active para autores; engaging para cualquiera de los dos tipos de objetivo. Uno de: `helpful`, `active`, `engaging`.
`--weights <json>`	el conjunto completo de pesos de los componentes; sustituye los pesos predefinidos.
`--message-kind <kind>`	seleccionar antes de clasificar todos los mensajes o aquellos cuya condición de publicación o comentario esté confirmada. Uno de: `all`, `posts`, `comments`.
`--chat <chat>`	solo este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	todas las cuentas disponibles de este servicio de mensajería; personal, bots o all.
`--timezone <zone>`	zona horaria IANA para fechas y días activos.
`--exact`	las palabras sin campo coinciden en su forma exacta en lugar de por su raíz.
`--limit <n>`	filas clasificadas, 1–100.
`--saved <name\|id>`	ejecutar una consulta guardada o una ejecución de clasificación; las opciones introducidas sustituyen las almacenadas.

`tg stats messages evidence`

página limitada de mensajes, pares de respuestas o miembros de una cohorte desde una selección drilldown exacta

tg stats messages evidence <message> [options]

Argumento	Obligatoriedad	Qué es
`message`	required	ubicación canónica del mensaje o referencia de cohorte de retención desde drilldown.

Opción	Qué hace
`--selection <json>`	la selección de clasificación resuelta que devuelve drilldown.
`--component <name>`	el componente de clasificación expuesto.
`--limit <n>`	filas de evidencia, 1–100; 20 si no se indica.
`--cursor <cursor>`	continuar con el mismo componente y la misma huella de las evidencias almacenadas.

`tg stats contacts`

estadísticas sobre los autores humanos

`tg stats contacts responses`

número de respuestas y mediana/p90 del tiempo de respuesta de las personas elegidas

tg stats contacts responses [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	una consulta Lucene estricta; si se omite, selecciona todos los mensajes almacenados.

Opción	Qué hace
`--chat <chat>`	solo este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	todas las cuentas disponibles de este servicio de mensajería; personal, bots o all.
`--exact`	las palabras sin campo coinciden en su forma exacta en lugar de por su raíz.
`--saved <name\|id>`	ejecutar un informe guardado de este tipo; las opciones indicadas sustituyen las guardadas.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.
`--limit <n>`	filas del informe, 1–100; 20 por defecto.
`--answerer <person>`	nombre guardado, alias, @username, ID o person:provider/account/id; los nombres ambiguos requieren elegir; repetir para varias.

`tg stats contacts top`

clasificar autores humanos de mensajes guardados por métrica o puntuación explicable; cada contador indica la frescura de su observación

tg stats contacts top [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	una consulta Lucene estricta; si se omite, selecciona todos los mensajes almacenados.

Opción	Qué hace
`--sync-first`	primero descarga los mensajes nuevos dentro de los límites de chats, tiempo y mensajes.
`--max-chats <n>`	actualiza como máximo este número de chats (predeterminado: 5).
`--sync-time <duration>`	deja de descargar tras este tiempo (predeterminado: 30s).
`--max-messages <n>`	descarga como máximo este número de mensajes en total (predeterminado: 500).
`--measure <name>`	métrica de clasificación; no se combina con score ni weights. Uno de: `messages`, `words`, `reactions`, `replies`, `answers`, `answer-time`, `threads`, `active-days`.
`--score <preset>`	helpful/active para autores; engaging para cualquiera de los dos tipos de objetivo. Uno de: `helpful`, `active`, `engaging`.
`--weights <json>`	el conjunto completo de pesos de los componentes; sustituye los pesos predefinidos.
`--message-kind <kind>`	seleccionar antes de clasificar todos los mensajes o aquellos cuya condición de publicación o comentario esté confirmada. Uno de: `all`, `posts`, `comments`.
`--chat <chat>`	solo este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	todas las cuentas disponibles de este servicio de mensajería; personal, bots o all.
`--timezone <zone>`	zona horaria IANA para fechas y días activos.
`--exact`	las palabras sin campo coinciden en su forma exacta en lugar de por su raíz.
`--limit <n>`	filas clasificadas, 1–100.
`--saved <name\|id>`	ejecutar una consulta guardada o una ejecución de clasificación; las opciones introducidas sustituyen las almacenadas.
`--min-messages <n>`	mínimo de mensajes seleccionados por autor; 1 o 5 para engaging.

`tg stats contacts evidence`

página limitada de mensajes, pares de respuestas o miembros de una cohorte desde una selección drilldown exacta

tg stats contacts evidence <person> [options]

Argumento	Obligatoriedad	Qué es
`person`	obligatorio	el identificador nativo exacto de la persona de la fila de clasificación.

Opción	Qué hace
`--selection <json>`	la selección de clasificación resuelta que devuelve drilldown.
`--component <name>`	el componente de clasificación expuesto.
`--limit <n>`	filas de evidencia, 1–100; 20 si no se indica.
`--cursor <cursor>`	continuar con el mismo componente y la misma huella de las evidencias almacenadas.

`tg stats chats`

estadísticas sobre un chat

`tg stats chats show`

las cifras de un grupo o canal en un periodo: mensajes, miembros activos, respuestas, reacciones, preguntas contestadas, entradas y salidas; se cuentan a partir del archivo local, y las entradas y salidas se piden al servicio

tg stats chats show <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
`--since-time <time>`	fecha ISO 8601 o intervalo anterior como 2h / 1d; hace 7 días por defecto.
`--by <day\|week>`	también una fila por día o semana natural (las semanas empiezan el lunes).
`--timezone <zone>`	zona horaria IANA para los días del calendario.

`tg stats chats newcomers`

miembros con fecha de entrada conocida y ayuda durante el plazo posterior

tg stats chats newcomers <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
`--since-time <time>`	desde esta fecha ISO 8601 o hace 2h / 1d; hace 30d por defecto.
`--until-time <time>`	hasta esta fecha ISO 8601 o hace 2h / 1d, inclusive.
`--within <duration>`	plazo de ayuda tras la entrada conocida de una persona nueva.
`--saved <name\|id>`	ejecutar un informe guardado de este tipo; las opciones indicadas sustituyen las guardadas.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.
`--limit <n>`	filas del informe, 1–100; 20 por defecto.
`--answerer <person>`	nombre guardado, alias, @username, ID o person:provider/account/id; los nombres ambiguos requieren elegir; repetir para varias.

`tg stats chats retention`

cohortes de incorporación y pertenencia observada en fechas de control a partir de listas guardadas

tg stats chats retention <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
`--since-time <time>`	inicio del período de incorporación en ISO 8601 o tiempo relativo; últimos 90 días por defecto.
`--until-time <time>`	fin del período de incorporación; ahora por defecto.
`--checkpoints <durations>`	hasta 10 edades crecientes desde la incorporación, separadas por comas; 1d,7d,30d por defecto.
`--within <duration>`	ventana de actividad y salida temprana tras incorporarse; 7d por defecto.
`--by <day\|week>`	agrupar fechas de incorporación por día o semana desde el lunes. Uno de: `day`, `week`.
`--timezone <zone>`	zona horaria IANA para cohortes de incorporación.
`--limit <n>`	cohortes y pruebas de miembros, 1–100.

`tg stats chats official`

lo que Telegram calcula para un grupo o canal que administras: totales comparados con el periodo anterior, participantes destacados y cada gráfico como series JSON; el servicio de mensajería elige el periodo

tg stats chats official <chat>

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

`tg stats tasks`

estadísticas de las tareas

`tg stats tasks show`

por chat: cuántas tareas están abiertas, la más antigua y la mediana del tiempo hasta el cierre

tg stats tasks show [options]

Opción	Qué hace
`--chat <chat>`	solo este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--type <name>`	solo este tipo: question, request, mention o promise.

`tg stats charts`

los datos de un gráfico de las estadísticas de un chat y, opcionalmente, una imagen SVG o PNG de tema oscuro

tg stats charts <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
`--chart-kind <messages\|active\|membership>`	qué dibujar: mensajes, autores activos o entradas y salidas. Predeterminado: `messages`.
`--by <day\|week>`	un punto por día o semana del calendario (las semanas empiezan el lunes). Predeterminado: `day`.
`--since-time <time>`	fecha ISO 8601 o intervalo anterior como 2h / 1d; hace 7 días por defecto.
`--timezone <zone>`	zona horaria IANA para los días del calendario.
`--output <file>`	guardar una imagen de tema oscuro en un nuevo archivo .svg o .png.

`tg tasks`

lo que requiere tu atención —preguntas sin respuesta, menciones, peticiones y promesas— guardado en el almacenamiento local; review y serve lo añaden

`tg tasks list`

tareas, primero las más antiguas, con su mensaje o nota de origen

tg tasks list [options]

Opción	Qué hace
`--state <state>`	solo tareas en este estado: open, done o dismissed.
`--chat <chat>`	solo las tareas de este chat: su título o parte de él, su identificador, @username o `me` para Mensajes guardados.
`--type <names>`	solo estos tipos, separados por comas: question, request, mention, promise.
`--before-time <time>`	solo tareas abiertas antes de esta fecha ISO 8601 o de hace 2h / 1d.
`--limit <n>`	cuántos.

`tg tasks add`

añadir una tarea para un mensaje o una nota guardados — una promesa o una petición

tg tasks add <message> [options]

Argumento	Obligatoriedad	Qué es
`message`	obligatorio	un localizador de mensaje, msg:///, o note:.

Opción	Qué hace
`--type <name>`	tipo de tarea: question, request, mention o promise.

`tg tasks close`

cerrar una tarea: done o dismissed si no necesita respuesta; una tarea cerrada permanece cerrada

tg tasks close <task> [options]

Argumento	Obligatoriedad	Qué es
`task`	obligatorio	el identificador de la tarea tal como lo muestra tasks list.

Opción	Qué hace
`--as <state>`	cómo se cierra: done o dismissed — no necesita respuesta.
`--reason <text>`	el motivo, guardado con la tarea — no-reply-needed, por ejemplo.

`tg search`

buscar por texto: search all para todo lo que guarda el almacenamiento local, o un solo recurso

`tg search all`

buscar en todo lo que guarda el almacenamiento local — mensajes del servicio de mensajería, correo y notas —, mejores coincidencias primero; empieza aquí si no sabes dónde se escribió algo

tg search all <query> [options]

Argumento	Obligatoriedad	Qué es
`query`	obligatorio	consulta estricta de Lucene: palabras, "frases", AND/OR/NOT, grupos de campos e intervalos de fechas.

Opción	Qué hace
`--only <resources>`	solo estos, separados por comas: messages, mail, notes.
`--limit <n>`	cuántos.
`--exact`	las palabras sin campo y las frases entre comillas coinciden solo en su forma exacta, como exact:word.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.

`tg search messages`

buscar mensajes del servicio de mensajería en el almacenamiento local y en su servidor (--backend); opcionalmente descargar mensajes nuevos con --sync-first

tg search messages [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	consulta estricta de Lucene: palabras, "frases", AND/OR/NOT, grupos de campos e intervalos de fechas; --language legacy conserva la búsqueda aproximada; con --saved, palabras adicionales unidas con AND.

Opción	Qué hace
`--sync-first`	primero descarga los mensajes nuevos dentro de los límites de chats, tiempo y mensajes.
`--max-chats <n>`	actualiza como máximo este número de chats (predeterminado: 5).
`--sync-time <duration>`	deja de descargar tras este tiempo (predeterminado: 30s).
`--max-messages <n>`	descarga como máximo este número de mensajes en total (predeterminado: 500).
`--thread`	la cadena de respuestas guardada y sus respuestas en lugar de los mensajes cercanos en el tiempo; recurre a estos si no existe el grafo.
`--thread-hops <n>`	como máximo este número de vínculos desde el resultado (predeterminado: 8).
`--thread-messages <n>`	como máximo este número de mensajes en cada contexto de hilo (predeterminado: 50).
`--thread-bytes <n>`	como máximo este número de bytes de mensajes completos y vínculos en cada contexto (predeterminado: 65536).
`--thread-within <duration>`	mensajes dentro de este intervalo a ambos lados del resultado (predeterminado: 1d).
`--backend <archive\|server\|both>`	dónde buscar: el archivo local, el servidor del servicio de mensajería o ambos (predeterminado: both).
`--server-time <duration>`	dejar de esperar al servidor tras este tiempo (predeterminado: 5s).
`--chat <chat>`	solo este chat, igual que chat: en la consulta; título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	todas las cuentas de este servicio guardadas, personal, bots o all; igual que in: en la consulta.
`--type <text\|voice\|file>`	solo mensajes de este tipo: solo texto, un mensaje de voz o un archivo.
`--limit <n>`	cuántos.
`--newest`	recientes primero en lugar de mejores coincidencias.
`--exact`	las palabras sin campo y las frases entre comillas coinciden solo en su forma exacta, como exact:word; text: sigue admitiendo todas las formas.
`--context <n>`	mensajes anteriores y posteriores a cada resultado; 2 en terminal, 0 en otros casos.
`--language <lucene\|legacy>`	lenguaje de consulta: Lucene estricto o búsqueda aproximada heredada.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.
`--regex`	interpreta el texto como expresión regular sin distinguir mayúsculas; comprueba todos los textos guardados.
`--saved <name\|id>`	ejecuta una búsqueda guardada o una ejecución anterior; las opciones escritas aquí sustituyen a las suyas.

`tg search mail`

buscar en el correo importado al almacenamiento local; memo mail import lo trae

tg search mail [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	consulta estricta de Lucene: palabras, "frases", AND/OR/NOT, grupos de campos e intervalos de fechas.

Opción	Qué hace
`--chat <chat>`	solo este hilo de correo, por identificador o asunto.
`--limit <n>`	cuántos.
`--newest`	recientes primero en lugar de mejores coincidencias.
`--exact`	las palabras sin campo y las frases entre comillas coinciden solo en su forma exacta, como exact:word; text: sigue admitiendo todas las formas.
`--context <n>`	mensajes anteriores y posteriores a cada resultado; 2 en terminal, 0 en otros casos.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.

`tg search notes`

buscar en las notas — escritas en memo o importadas de una carpeta de notas — por palabras y, con el modelo de texto local, por significado; cada resultado indica qué lo encontró y a qué enlaza

tg search notes <query> [options]

Argumento	Obligatoriedad	Qué es
`query`	obligatorio	consulta estricta de Lucene: palabras, "frases", AND/OR/NOT, tag: e intervalos de fechas.

Opción	Qué hace
`--type <internal\|file>`	solo notas escritas en memo, o solo notas de una carpeta.
`--folder <id>`	solo esta carpeta de notas, por su identificador; repite para incluir varias.
`--tag <tag>`	solo notas con esta etiqueta.
`--filter <query>`	una consulta que también debe cumplir cada resultado; no cambia la búsqueda por significado.
`--limit <n>`	cuántos.
`--offset <n>`	omite este número de resultados, para la página siguiente.
`--exact`	solo las palabras tal como están escritas; no se busca por significado.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.

`tg search conversations`

conversaciones más próximas por significado y palabras, mejores primero, en uno o todos los chats; significado tras conversations embed, en este equipo

tg search conversations <query> [options]

Argumento	Obligatoriedad	Qué es
`query`	obligatorio	qué buscar, con tus palabras, en un idioma que entienda el modelo.

Opción	Qué hace
`--model <model>`	local: identificador de `models text list` (predeterminado: e5-small); remoto: modelo del proveedor.
`--provider <provider>`	proveedor de vectores: local u openai; las opciones tienen prioridad sobre los ajustes del perfil.
`--base-url <url>`	servidor compatible con /v1/embeddings de OpenAI: Gemini, Jina, Ollama o LM Studio local.
`--dims <n>`	remoto: tamaño vectorial; necesario con --base-url y reduce el de modelos OpenAI.
`--max-chats <n>`	como máximo este número de chats; 5 con --sync-first y 20 con --refresh por defecto.
`--max-chunks <n>`	como máximo este número de fragmentos con vector calculado en una ejecución; 2000 por defecto.
`--sync-first`	primero descarga los mensajes nuevos dentro de los límites de chats, tiempo y mensajes.
`--sync-time <duration>`	deja de descargar tras este tiempo (predeterminado: 30s).
`--max-messages <n>`	descarga como máximo este número de mensajes en total (predeterminado: 500).
`--chat <chat>`	solo este chat, por título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--since-time <time>`	solo conversaciones aún activas desde esta fecha ISO 8601 o intervalo anterior como 30m / 2h / 1d.
`--filter <query>`	filtro estricto de Lucene: algún mensaje de la conversación debe cumplirlo; no cambia la consulta por significado.
`--source <source>`	cuentas en las que buscar: personal, bots, all o un proveedor; por defecto, la cuenta activa.
`--timezone <zone>`	zona horaria IANA para las fechas del filtro; por defecto, la del sistema.
`--limit <n>`	cuántos.
`--refresh`	primero analiza y calcula vectores, en este equipo, de los chats del alcance que cambiaron o nunca se analizaron, dentro de --max-chats y --max-chunks.

`tg search topics`

temas del foro cuyos títulos coinciden

tg search topics <chat> <text> [options]

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

Opción	Qué hace
`--limit <n>`	cuántos mostrar.
`--page <n>`	número de página, desde 1.
`--all`	todas las filas, sin paginar.

`tg searches`

búsquedas guardadas e historial de search messages y stats messages show en el almacenamiento local; --saved ejecuta una

`tg searches create`

guarda una búsqueda con un nombre sin ejecutarla; search messages --saved la ejecuta

tg searches create <name> [query] [options]

Argumento	Obligatoriedad	Qué es
`name`	obligatorio	hasta 64 letras a–z, cifras y guiones, no solo cifras.
`query`	opcional	la consulta, como en search messages; sin consulta coincide con todos los mensajes guardados.

Opción	Qué hace
`--chat <chat>`	solo este chat, igual que chat: en la consulta; título completo o parcial, identificador, @username o `me` para Mensajes guardados.
`--source <messenger>`	todas las cuentas de este servicio guardadas, personal, bots o all; igual que in: en la consulta.
`--limit <n>`	cuántos.
`--newest`	recientes primero en lugar de mejores coincidencias.
`--exact`	las palabras sin campo y las frases entre comillas coinciden solo en su forma exacta, como exact:word; text: sigue admitiendo todas las formas.
`--context <n>`	mensajes anteriores y posteriores a cada resultado.
`--language <lucene\|legacy>`	lenguaje de consulta: Lucene estricto o búsqueda aproximada heredada.
`--timezone <zone>`	zona horaria IANA para los límites de fechas del calendario.
`--regex`	interpreta el texto como expresión regular sin distinguir mayúsculas; comprueba todos los textos guardados.
`--by <chat\|sender\|day\|hour>`	por qué criterio agrupa el recuento stats messages show --saved.
`--selection <json>`	guardar la consulta de clasificación principal resuelta y sus opciones a partir de una vista detallada.
`--replace`	sobrescribe una búsqueda guardada con el mismo nombre.

`tg searches show`

una búsqueda guardada o una ejecución anterior: su consulta, sus opciones y cuántas veces se ejecutó

tg searches show <name|id>

Argumento	Obligatoriedad	Qué es
`name\|id`	obligatorio	nombre de una búsqueda guardada, o identificador de cualquier fila de searches history.

`tg searches list`

las búsquedas guardadas, por nombre

tg searches list

`tg searches history`

las búsquedas y recuentos ejecutados, recientes primero, incluidas las guardadas; nunca sus resultados

tg searches history [options]

Opción	Qué hace
`--limit <n>`	cuántos.

`tg searches delete`

elimina una búsqueda guardada o una ejecución del historial

tg searches delete <name|id>

Argumento	Obligatoriedad	Qué es
`name\|id`	obligatorio	nombre de una búsqueda guardada, o identificador de cualquier fila de searches history.

`tg searches clear`

vacía el historial; las búsquedas guardadas se conservan

tg searches clear

`tg flood`

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

`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í

tg flood clear

`tg replies`

reglas que responden mensajes por ti, guardadas en un archivo de este perfil

`tg replies add`

añadir una regla con todos los valores predeterminados explícitos, desactivada hasta que la edites y actives

Solo hace cambios en este equipo.

tg replies add <id>

Argumento	Obligatoriedad	Qué es
`id`	obligatorio	letras minúsculas, dígitos y -; único en este perfil.

`tg replies on`

activar una regla de respuesta; su plantilla debe estar lista

Solo hace cambios en este equipo.

tg replies on <id>

Argumento	Obligatoriedad	Qué es
`id`	obligatorio	el identificador de la regla.

`tg replies off`

desactivar una regla de respuesta

Solo hace cambios en este equipo.

tg replies off <id>

Argumento	Obligatoriedad	Qué es
`id`	obligatorio	el identificador de la regla.

`tg replies edit`

cambiar solo los campos indicados de una regla de respuesta; las listas se sustituyen completas

Solo hace cambios en este equipo.

tg replies edit <id> [options]

Argumento	Obligatoriedad	Qué es
`id`	obligatorio	el identificador de la regla.

Opción	Qué hace
`--do <actions>`	acciones: reply, task o ambas, separadas por comas.
`--kinds <kinds>`	tipos de chat: dialog, group; separados por comas, vacío para cualquiera.
`--chats <ids>`	solo estos identificadores de chat, separados por comas; vacío para cualquiera.
`--not-chats <ids>`	excluir estos identificadores de chat, separados por comas; vacío borra la lista.
`--words <words>`	coincidir con cualquiera de estas palabras completas, separadas por comas; vacío borra la lista.
`--question`	coincidir solo con preguntas.
`--no-question`	no exigir una pregunta.
`--mentions-me`	exigir que te mencionen o que respondan a tu mensaje.
`--no-mentions-me`	no exigir que te mencionen ni que respondan a tu mensaje.
`--people <ids>`	solo estos identificadores de remitentes, separados por comas; vacío para cualquiera.
`--not-people <ids>`	excluir estos identificadores de remitentes, separados por comas; vacío borra la lista.
`--contacts-only`	coincidir solo con contactos.
`--no-contacts-only`	no exigir que el remitente sea un contacto.
`--template <text>`	la plantilla de respuesta.
`--model <mode>`	modo de plantilla antiguo: fill-only o may-reword; usa bloques ai en su lugar.
`--as-reply`	enviar como respuesta al mensaje coincidente.
`--no-as-reply`	enviar sin vincular al mensaje coincidente.
`--per-chat <limit>`	como máximo esta cantidad por chat, como 1/12h.
`--per-person <limit>`	como máximo esta cantidad por persona, como 1/1d.
`--outside <hours>`	responder fuera de este intervalo en formato de 24 horas, como 09:00-19:00.
`--days <days>`	días del intervalo de trabajo, como mon-fri o sat,sun.
`--timezone <zone>`	zona horaria IANA del intervalo de trabajo.
`--no-hours`	borrar el intervalo de trabajo.

`tg replies audience`

mostrar la audiencia de respuestas del perfil o sustituir los campos indicados; los probadores siguen limitando las respuestas

Solo hace cambios en este equipo.

tg replies audience [options]

Opción	Qué hace
`--reply <mode>`	responder a todos o solo a los remitentes y chats de la lista: all, listed.
`--allow-people <ids>`	sustituir los identificadores de remitentes permitidos, separados por comas; vacío borra la lista.
`--allow-chats <ids>`	sustituir los identificadores de chats permitidos, separados por comas; vacío borra la lista.
`--deny-people <ids>`	sustituir los identificadores de remitentes prohibidos, separados por comas; vacío borra la lista; la prohibición tiene prioridad.
`--deny-chats <ids>`	sustituir los identificadores de chats prohibidos, separados por comas; vacío borra la lista; la prohibición tiene prioridad.

`tg replies consents`

consentimiento para los modelos de respuesta una vez por perfil y endpoint, con exclusiones por chat

`tg replies consents show`

mostrar el consentimiento para el modelo de respuesta y las exclusiones de chats; nunca llama a un modelo

tg replies consents show

`tg replies consents grant`

permitir que los datos de mensajes entrantes se envíen al modelo de respuesta configurado para este perfil; se conservan las exclusiones de chats

Solo hace cambios en este equipo.

tg replies consents grant

`tg replies consents revoke`

revocar de inmediato el consentimiento del perfil para el modelo de respuesta; se conservan las exclusiones de chats

Solo hace cambios en este equipo.

tg replies consents revoke

`tg replies consents deny`

evitar que los datos entrantes de este chat se envíen al modelo de respuesta

Solo hace cambios en este equipo.

tg replies consents deny <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	el identificador nativo del chat, usado tal como se escribe; nunca se resuelve mediante la red.

`tg replies consents allow`

eliminar la exclusión de este chat del modelo; no concede consentimiento al perfil

Solo hace cambios en este equipo.

tg replies consents allow <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	el identificador nativo del chat, usado tal como se escribe; nunca se resuelve mediante la red.

`tg replies test`

qué habrían respondido las reglas a los mensajes guardados, a quién y por qué; no envía ni cambia nada y nunca se conecta

tg replies test [rule] [options]

Argumento	Obligatoriedad	Qué es
`rule`	opcional	solo esta regla, por su identificador; todas las reglas en el orden del archivo por defecto.

Opción	Qué hace
`--since-time <time>`	desde esta fecha ISO 8601 o intervalo anterior como 2h / 1d; hace 7d por defecto.
`--ai`	llamar al modelo de respuesta configurado con datos de mensajes almacenados; requiere consentimiento para el modelo de respuesta, de lo contrario usa la alternativa.

`tg replies pause`

detiene a la vez todas las reglas de respuesta de este perfil, también en un serve en marcha; resume lo deshace

tg replies pause

`tg replies resume`

permite que las reglas de respuesta vuelvan a contestar tras pause

tg replies resume

`tg replies status`

si las reglas pueden enviar, cuáles están activas y a quién pueden responder

tg replies status

`tg recipients`

chats permitidos para este perfil si la lista está activa

`tg recipients list`

chats de la lista; vacía e inactiva hasta añadir el primero

tg recipients list

`tg recipients add`

permite enviar al chat; el primer añadido activa la lista

Solo hace cambios en este equipo.

tg recipients add <chat>

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

`tg recipients remove`

retira el permiso del chat; la lista sigue activa

Solo hace cambios en este equipo.

tg recipients remove <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	identificador de chat o título tal como aparece en la lista.

`tg recipients clear`

elimina y desactiva la lista; el perfil vuelve a poder enviar a cualquier chat

Solo hace cambios en este equipo.

tg recipients clear

`tg sends`

todos los intentos de envío del perfil, nunca el texto

`tg sends list`

intentos recientes primero: enviados, rechazados, fallidos o desconocidos

tg sends list [options]

Opción	Qué hace
`--limit <n>`	cuántos mostrar.

`tg runs`

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

`tg runs list`

ejecuciones registradas, recientes primero

tg runs list [options]

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

`tg runs show`

una ejecución: información general y una línea por operación

tg runs show <run-id>

Argumento	Obligatoriedad	Qué es
`run-id`	obligatorio	identificador de `tg runs list`.

`tg runs path`

directorio de una ejecución

tg runs path <run-id>

Argumento	Obligatoriedad	Qué es
`run-id`	obligatorio	identificador de `tg runs list`.

`tg config`

ajustes efectivos y origen de cada valor

`tg config migrate`

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

Solo hace cambios en este equipo.

tg config migrate [options]

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

`tg config show`

perfil, perfiles existentes y ajustes con su origen

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`

guarda un ajuste en la configuración

Solo hace cambios en este equipo.

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, searchStemmers.cyrillic, searchStemmers.latin.
`value`	obligatorio	número, true o false; para allow, lista como send,reaction.

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`

elimina un ajuste de la configuración

Solo hace cambios en este equipo.

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, searchStemmers.cyrillic, searchStemmers.latin.

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`

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

tg doctor [options]

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

`tg doctor report`

contenido de un informe de problema; no escribe nada

`tg doctor report create`

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

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`

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

`tg commands schema`

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

tg commands schema <path>

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

`tg complete`

autocompletado: tg complete zsh imprime el script que debe cargarse

tg complete [words]

Argumento	Obligatoriedad	Qué es
`words`	opcional

`tg upgrade`

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

tg upgrade [options]

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

`tg mcp`

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

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://.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`

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

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`

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

Solo hace cambios en este equipo.

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`

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

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`

instrucciones para que un agente utilice la herramienta

`tg skill show`

imprime SKILL.md; tg skill install lo coloca donde lo buscan Claude Code, Codex y Gemini CLI

tg skill show [name]

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

`tg skill install`

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

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

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.

Opciones comunes a todos los comandosCopy Anchor Link

ComandosCopy Anchor Link

tg sessionCopy Anchor Link

tg session startCopy Anchor Link

tg session endCopy Anchor Link

tg setupCopy Anchor Link

tg accountCopy Anchor Link

tg account listCopy Anchor Link

tg account showCopy Anchor Link

tg account updateCopy Anchor Link

tg account sessionsCopy Anchor Link

tg account sessions listCopy Anchor Link

tg account sessions endCopy Anchor Link

tg chatsCopy Anchor Link

tg chats listCopy Anchor Link

tg chats eventsCopy Anchor Link

tg chats inspectCopy Anchor Link

tg chats showCopy Anchor Link

tg chats send-asCopy Anchor Link

tg chats mark-readCopy Anchor Link

tg chats trackingCopy Anchor Link

tg chats tracking listCopy Anchor Link

tg chats tracking showCopy Anchor Link

tg chats tracking addCopy Anchor Link

tg chats tracking removeCopy Anchor Link

tg chats joinCopy Anchor Link

tg chats leaveCopy Anchor Link

tg chats foldersCopy Anchor Link

tg chats folders listCopy Anchor Link

tg chats folders showCopy Anchor Link

tg chats folders createCopy Anchor Link

tg chats folders updateCopy Anchor Link

tg chats folders deleteCopy Anchor Link

tg chats folders orderCopy Anchor Link

tg chats folders joinCopy Anchor Link

tg chats rulesCopy Anchor Link

tg chats rules showCopy Anchor Link

tg chats rules setCopy Anchor Link

tg chats rules unsetCopy Anchor Link

tg contactsCopy Anchor Link

tg contacts listCopy Anchor Link

tg contacts showCopy Anchor Link

tg contacts profileCopy Anchor Link

tg contacts contextCopy Anchor Link

tg contacts checkCopy Anchor Link

tg contacts linkCopy Anchor Link

tg contacts unlinkCopy Anchor Link

tg contacts lookupCopy Anchor Link

tg contacts syncCopy Anchor Link

tg contacts aliasCopy Anchor Link

tg contacts alias setCopy Anchor Link

tg contacts alias rmCopy Anchor Link

tg contacts notesCopy Anchor Link

tg contacts notes listCopy Anchor Link

tg contacts notes showCopy Anchor Link

tg contacts notes addCopy Anchor Link

tg contacts notes editCopy Anchor Link

tg contacts notes removeCopy Anchor Link

tg contacts addCopy Anchor Link

tg contacts removeCopy Anchor Link

tg contacts blockCopy Anchor Link

tg contacts unblockCopy Anchor Link

tg contacts renameCopy Anchor Link

tg contacts importCopy Anchor Link

tg messagesCopy Anchor Link

tg messages evidenceCopy Anchor Link

tg messages listCopy Anchor Link

tg messages sendCopy Anchor Link

tg messages showCopy Anchor Link

tg messages contextCopy Anchor Link

tg messages downloadCopy Anchor Link

tg messages transcribeCopy Anchor Link

tg messages editCopy Anchor Link

tg messages deleteCopy Anchor Link

tg messages forwardCopy Anchor Link

tg messages pinCopy Anchor Link

tg messages unpinCopy Anchor Link

tg messages scheduledCopy Anchor Link

tg messages linkCopy Anchor Link

Opciones comunes a todos los comandos

Comandos

`tg session`

`tg session start`

`tg session end`

`tg setup`

`tg account`

`tg account list`

`tg account show`

`tg account update`

`tg account sessions`

`tg account sessions list`

`tg account sessions end`

`tg chats`

`tg chats list`

`tg chats events`

`tg chats inspect`

`tg chats show`

`tg chats send-as`

`tg chats mark-read`

`tg chats tracking`

`tg chats tracking list`

`tg chats tracking show`

`tg chats tracking add`

`tg chats tracking remove`

`tg chats join`

`tg chats leave`

`tg chats folders`

`tg chats folders list`

`tg chats folders show`

`tg chats folders create`

`tg chats folders update`

`tg chats folders delete`

`tg chats folders order`

`tg chats folders join`

`tg chats rules`

`tg chats rules show`

`tg chats rules set`

`tg chats rules unset`

`tg contacts`

`tg contacts list`

`tg contacts show`

`tg contacts profile`

`tg contacts context`

`tg contacts check`

`tg contacts link`

`tg contacts unlink`

`tg contacts lookup`

`tg contacts sync`

`tg contacts alias`

`tg contacts alias set`

`tg contacts alias rm`

`tg contacts notes`

`tg contacts notes list`

`tg contacts notes show`

`tg contacts notes add`

`tg contacts notes edit`

`tg contacts notes remove`

`tg contacts add`

`tg contacts remove`

`tg contacts block`

`tg contacts unblock`

`tg contacts rename`

`tg contacts import`

`tg messages`

`tg messages evidence`

`tg messages list`

`tg messages send`

`tg messages show`

`tg messages context`

`tg messages download`

`tg messages transcribe`

`tg messages edit`

`tg messages delete`

`tg messages forward`

`tg messages pin`

`tg messages unpin`

`tg messages scheduled`

`tg messages link`

`tg messages comments`