Ir al contenido

Referencia de comandos

{/_ GENERATED by tools/help/generate-cli-reference.mjs — do not edit by hand. _/}

Esta página se genera a partir del analizador de la línea de comandos, de modo que no puede contradecir al programa. tcc <comando> --help muestra la misma información en la terminal.

180 comandos, 89 opciones. Los corchetes angulares son obligatorios; los cuadrados, opcionales.

Se pueden indicar en cualquier comando.

  • --account — Actuar como otra cuenta de este equipo, solo para este comando
  • --dry-run — Vista previa sin hacer cambios (solo en comandos que modifican)
  • --db, -e, --env — Con qué servidor hablar (local/dev/prod)
  • --json, -j — Salida en JSON (legible por máquina)
  • --quiet, -q — Omitir la salida no esencial
  • --server — Sustituir la dirección del servicio tcc remoto en esta llamada. Equivale a la variable TCC_REMOTE_URL. Útil en guiones y en CI, donde exportar variables resulta incómodo. Úselo junto a --token
  • --token — Token de API (tc_live_* / tc_test_*) para el servicio remoto. Equivale a la variable de entorno TCC_API_TOKEN. Obligatorio siempre que se indique --server (o su equivalente de entorno)
  • --verbose, -v — Incluir la respuesta completa de la API en la salida

Cuentas en este equipo y el ciclo de vida de esta cuenta

Eliminar esta cuenta y todo lo que contiene. IRREVERSIBLE

Quitar una cuenta de este equipo

Argumentos

  • <id_or_email> — Identificador de la cuenta, o la dirección con la que entra

Listar las cuentas con sesión iniciada en este equipo (por defecto)

Abrir una página del portal de la cuenta, con la sesión iniciada (muestra un enlace de un solo uso)

Argumentos

  • [target] — La página del portal, p. ej. account o emails — Valor por defecto account

Cambiar la cuenta con la que actúa este equipo

Argumentos

  • <id_or_email> — Identificador de la cuenta, o la dirección con la que entra

Gestionar los tokens de API del servidor (para el acceso programático)

Generar un token de API del servidor

Argumentos

  • <name> — Nombre descriptivo (por ejemplo, «canal de CI»)

Opciones

  • --scopes — Permisos separados por comas (opcional)

Listar todos los tokens de API del servidor

Revocar un token de API del servidor por su identificador

Argumentos

  • <id> — Identificador del token (de la lista)

Hacer una pregunta al asistente

Argumentos

  • [message] — Lo que quiere preguntar, por ejemplo «cuál es el código de Mark»

Opciones

  • --answer — Answer a question from a previous —json run with this value (a choice’s value, or free text); needs —envelope
  • --envelope — The data.ask JSON the previous run printed — a file, or - for stdin

Valorar una respuesta del asistente

Argumentos

  • <chat_log_id> — El identificador que la respuesta llevaba en data.chatLogId
  • <rating> — útil | no útil

Autenticación (entrar, salir, estado)

Adoptar una sesión desde la entrada estándar, sin navegador

Iniciar sesión: abre el navegador, o con —code usa el código del correo de inicio de sesión

Opciones

  • --code — Iniciar sesión con el código del correo de inicio de sesión en lugar del navegador
  • --email — La dirección a la que se envía el código (se pregunta si falta)

Borrar los tokens del llavero

Mostrar el estado de la sesión

Imprimir el token de acceso (apto para tuberías)

Operaciones con códigos de un solo uso

Listar todos los códigos

Mostrar cuándo cambia el código

Mostrar el código actual de tres palabras de un nombre: conexión o código de invitado

Argumentos

  • <name> — Nombre de la conexión o etiqueta del código de invitado (basta con parte)

Opciones

  • --kind — Solo un tipo: connection o guest
  • --lang — Idioma distinto del habitual

Configuración

Quitar el servicio remoto guardado — las llamadas siguientes usan el servicio local (si está activo) o el modo autónomo

Crear un token de API para el acceso HTTP

Opciones

  • --label — Etiqueta del token (por ejemplo, «claude-ai», «chatgpt»)
  • --scope — Permiso del token: lectura, escritura o total
  • --ttl-hours — Validez en horas (omítalo para que no caduque; solo en local)

Listar todos los tokens de API (enmascarados)

Restablecer el dispositivo — borrar los datos del usuario y volver a registrarlo en el próximo uso

Revocar un token de API por su etiqueta

Argumentos

  • <label> — Etiqueta del token

Guardar un servicio tcc remoto como destino por defecto. Escribe en ~/.config/tcc/config.toml y se lee en cada invocación, salvo que --server o TCC_REMOTE_URL lo sustituyan

Argumentos

Opciones

  • --token — Token de API (tc_live_* / tc_test_*) que acompaña a esta dirección — obligatorio

Consultar o fijar el atajo de teclado global para sellar. Ejemplo: tcc config shortcut “CmdOrCtrl+Shift+S”

Argumentos

  • [value] — Nuevo atajo (por ejemplo, «CmdOrCtrl+Shift+S»). Omítalo para ver el actual

Mostrar la configuración actual

Mostrar un token de API por su etiqueta (valor completo)

Argumentos

  • <label> — Etiqueta del token

Imprimir la dirección del servicio remoto guardada (token enmascarado)

Conectarse mediante un enlace abierto

Argumentos

  • <slug> — Dirección corta del enlace abierto (por ejemplo, «stefan/my-link»)

Gestionar las conexiones existentes

Añadir un miembro

Argumentos

  • <email> — Correo de la persona que se añade
  • <id> — Identificador de la conexión

Poner la imagen de la conexión desde un archivo local

Argumentos

  • <id> — Identificador de la conexión
  • <path> — Ruta a un archivo JPEG, PNG, WEBP o GIF

Cambiar cómo funcionan los códigos de identidad de esta conexión

Argumentos

  • <id> — Identificador de la conexión
  • <mode> — Modo: dedicated (palabras solo para esta conexión) o shared (todos en la conexión dicen las mismas palabras)

Eliminar una conexión

Argumentos

  • <id> — Identificador de la conexión

Marcar o desmarcar como favorita

Argumentos

  • <id> — Identificador de la conexión

Listar las conexiones con sus etiquetas

Mostrar los miembros

Argumentos

  • <id> — Identificador de la conexión

Quitar la imagen de la conexión

Argumentos

  • <id> — Identificador de la conexión

Quitar un miembro

Argumentos

  • <id> — Identificador de la conexión
  • <member_id> — Identificador del miembro (de members)

Transferir la propiedad a otro miembro

Argumentos

  • <id> — Identificador de la conexión
  • <new_owner_id> — Identificador del nuevo propietario (de members)

Cambiar los ajustes de la conexión (nombre, idioma, rotación, descripción)

Argumentos

  • <id> — Identificador de la conexión

Opciones

  • --description — Descripción
  • --lang — Nuevo idioma
  • --name — Nuevo nombre
  • --rotation-hours — Periodo de rotación en horas (por ejemplo, 1, 6, 24, 168 para semanal)

Servicio en segundo plano sin interfaz (servidores Linux, CI)

Instalar y activar como servicio de usuario de systemd (solo Linux)

Arrancar el servicio (HTTP, servidor MCP y sincronización)

Mostrar el estado del servicio

Detener el servicio en ejecución

Gestión de dispositivos (registrar, recuperar, estado)

Todos los dispositivos con sesión en esta CUENTA, no solo este

Introducir el código de recuperación para activar el cifrado extremo a extremo

Regenerar las palabras de recuperación (palabras nuevas, misma clave)

Opciones

  • --lang — Idioma de las palabras de recuperación (en, de, es, fr, it, nl)

Generar el par de claves y registrarlo en el servidor

Cerrar la sesión de un dispositivo en esta cuenta

Argumentos

  • <device_id> — Identificador del dispositivo (de tcc device list)

Opciones

  • --confirm-last-key-holder — Quitarlo aunque sea el último dispositivo que guarda la clave de la cuenta

Crear las palabras de recuperación (dispositivo primero o único)

Opciones

  • --lang — Idioma de las palabras de recuperación (en, de, es, fr, it, nl)

Mostrar el estado de registro del dispositivo

Direcciones de correo de esta cuenta

Quitar una dirección

Argumentos

  • <id> — Identificador de la dirección (de tcc email list)

Listar todas las direcciones de esta cuenta

Enviar un código de verificación a una dirección

Argumentos

  • <address> — La dirección que se verifica

Elegir la dirección que ven sus conexiones

Argumentos

  • <id> — Identificador de la dirección (de tcc email list)

Hacer que una dirección sea la principal

Argumentos

  • <id> — Identificador de la dirección (de tcc email list)

Introducir el código enviado a una dirección

Argumentos

  • <address> — La dirección
  • <code> — El código del correo

Exportación de datos — pedir una copia de todo lo que guarda esta cuenta

Quitar todas las exportaciones pedidas por esta cuenta

Obtener un enlace firmado y con caducidad a una exportación terminada

Argumentos

  • <export_id> — Identificador de la exportación (de tcc export list)

Las exportaciones pedidas por esta cuenta, listas o no

Pedir al servidor que prepare una exportación

Miembros externos (acceso web para quien no usa la aplicación)

Añadir un miembro externo (sin aplicación)

Argumentos

  • <email> — Dirección de correo
  • <name> — Nombre de la persona

Opciones

  • --lang — Idioma de las palabras del código
  • --tag — Nombre propio para la conexión

Listar todos los miembros externos

Revocar el acceso de un miembro externo

Argumentos

  • <member_id> — Identificador del miembro

Enviar comentarios al equipo. Se envían por correo, por eso solo existe en la línea de comandos

Argumentos

  • <category> — error | función | general
  • <message> — Lo que quiere decir (de 10 a 2000 caracteres)

Opciones

  • --rating — Valoración opcional, de 1 a 5

Códigos de invitado (para quien no usa la aplicación)

Crear un código de invitado

Argumentos

  • <name> — Nombre de la persona

Opciones

  • --expires — Horas hasta la caducidad
  • --lang — Idioma de las palabras del código

Listar todos los códigos de invitado

Generar un código QR para un código de invitado

Argumentos

  • <id> — Identificador del código de invitado (de list o create)

Revocar un código de invitado

Argumentos

  • <id> — Identificador del código de invitado (de la lista)

Buscar códigos de invitado por nombre

Argumentos

  • <query> — Texto de búsqueda

Enviar un código de invitado por correo

Argumentos

  • <id> — Identificador del código de invitado (de list o create)

Opciones

  • --to — Correo del destinatario — obligatorio

Poner tcc en su PATH para que la aplicación y la línea de comandos sean un solo programa

Opciones

  • --force — Sustituir un tcc existente que apunta a otro sitio

Crear conexiones y gestionar invitaciones

Aceptar una invitación dirigida a usted

Argumentos

  • <id> — Identificador de la invitación

Opciones

  • --force — Aceptar aunque la invitación indique otra dirección

Aceptar una invitación federada (un registro enviado aquí por otro nodo)

Argumentos

  • <id> — Identificador de la invitación pendiente

Aprobar la solicitud de otra persona para unirse a una conexión suya

Argumentos

  • <id> — Identificador de la invitación

Rechazar una invitación

Argumentos

  • <id> — Identificador de la invitación

Rechazar una invitación federada

Argumentos

  • <id> — Identificador de la invitación pendiente

Listar las invitaciones federadas que esperan a esta cuenta

Listar todas las invitaciones

Listar las solicitudes de aprobación pendientes

Ampliar la caducidad de una invitación pendiente

Argumentos

  • <id> — Identificador de la invitación

Crear una conexión y enviar invitaciones

Argumentos

  • <name> — Nombre de la conexión

Opciones

  • --duration — Borrado automático tras estas horas (-1 = nunca)
  • --lang — Idioma de las palabras del código
  • --message — Mensaje personal en el correo de invitación
  • --tags — Etiquetas (separadas por comas)
  • --to — Dirección o direcciones de correo, separadas por comas

Retirar una invitación enviada

Argumentos

  • <id> — Identificador de la invitación

Gestionar los enlaces abiertos que se pueden compartir

Aprobar una solicitud

Argumentos

  • <id> — Identificador de la solicitud

Cambiar la dirección del enlace

Argumentos

  • <id> — Identificador del enlace
  • <slug> — Nueva dirección corta

Crear un enlace abierto

Opciones

  • --approval — Modo de aprobación: automático o manual
  • --slug — Dirección corta propia

Rechazar una solicitud

Argumentos

  • <id> — Identificador de la solicitud

Eliminar un enlace

Argumentos

  • <id> — Identificador del enlace

Listar todos los enlaces abiertos

Pausar un enlace

Argumentos

  • <id> — Identificador del enlace

Listar las solicitudes de conexión pendientes

Reanudar un enlace

Argumentos

  • <id> — Identificador del enlace

Sugerir nombres de enlace disponibles

Comprobar si una dirección de correo está en Trusted Codes

Argumentos

  • <email> — Dirección de correo a comprobar

Integración MCP con aplicaciones de IA

Añadir Trusted Codes a una aplicación de IA

Argumentos

  • [app] — Aplicación de IA a configurar (claude-desktop, claude-code, cursor)

Quitar Trusted Codes de una aplicación de IA

Argumentos

  • <app> — Aplicación de IA de la que se quita (claude-desktop, claude-code, cursor)

Mostrar qué aplicaciones de IA tienen configurado Trusted Codes

Ver y gestionar las notificaciones

Eliminar notificaciones

Argumentos

  • [ids] — Identificadores de las notificaciones

Listar las notificaciones recientes

Opciones

  • --limit — Número máximo a mostrar
  • --unread — Mostrar solo las no leídas

Marcar notificaciones como leídas

Argumentos

  • [ids] — Identificadores de las notificaciones

En qué organización actúa y cómo cambiar de una a otra

Qué organización está activa en esta sesión y qué permite

Actuar en una organización, o volver al contexto personal

Argumentos

  • [organization_id] — Identificador de la organización. Omítalo junto a —personal para anular la elección

Opciones

  • --personal — Actuar como usted mismo y no dentro de una organización

One-time codes: three words, valid for one hour, one use

Opciones

  • --lang — Code language: en | de | es | fr | it | nl
  • --wait <value> — A new computer is trusted by the server after about 3 minutes: keep trying for up to this many seconds (bare --wait = 240)

Allow the page that claimed your generator words

Argumentos

  • <id> — The pairing id (from tcc otp devices)

Deny the page that claimed your generator words

Argumentos

  • <id> — The pairing id (from tcc otp devices)

List the devices that make your codes, and a page waiting for your decision

Make the words for a code generator page

Opciones

  • --lang — Language of the three words

List your codes

Make a one-time code (the default): prints the three words and the link

Opciones

  • --lang — Code language: en | de | es | fr | it | nl
  • --wait <value> — Keep trying for up to this many seconds while the server starts to trust this computer (bare --wait = 240)

Remove a device (its open codes stop working)

Argumentos

  • <id> — The device’s install id (from tcc otp devices)

Withdraw a code that is not used yet

Argumentos

  • <id> — The code’s id (from tcc otp list --json)

Lo que permite el plan de esta cuenta — funciones, límites y opciones

Opciones

  • --refresh — Preguntar al servidor en lugar de responder desde la base de datos local

Ver y cambiar las preferencias de notificación

Restablecer los valores por defecto

Activar o desactivar un canal de notificación

Argumentos

  • <channel> — Canal: correo, notificación push o dentro de la aplicación
  • <topic> — Tema (por ejemplo, invitation_received, security_alert)

Opciones

  • --enabled — Activado o desactivado

Mostrar las preferencias de notificación

Gestionar las plantillas de conexión

Crear una plantilla

Argumentos

  • <name> — Nombre de la plantilla

Opciones

  • --duration — Horas hasta el borrado automático
  • --lang — Idioma por defecto

Eliminar una plantilla

Argumentos

  • <id> — Identificador de la plantilla

Listar las plantillas

Fijar la plantilla por defecto (sin identificador, se borra)

Argumentos

  • [id] — Identificador de la plantilla (omítalo para borrar la predeterminada)

Cambiar una plantilla

Argumentos

  • <id> — Identificador de la plantilla

Opciones

  • --duration — Nuevas horas hasta el borrado automático
  • --lang — Nuevo idioma por defecto
  • --name — Nuevo nombre

Ver o cambiar el perfil

Mostrar el perfil (por defecto si no se indica subcomando)

Cambiar el idioma preferido

Argumentos

  • <language> — Código de idioma (en, de, es, fr, it, nl)

Cambiar el nombre mostrado

Argumentos

  • <name> — Nuevo nombre mostrado

Sellos de proveedor — crear códigos de procedencia de un solo uso desde este dispositivo

Listar los códigos creados desde esta cuenta

Crear un código de un solo uso: imprime las tres palabras y las copia al portapapeles

Opciones

  • --lang — Idioma del código: en | de | es | fr | it | nl. Por defecto, en

Preparar ESTE dispositivo para crear sellos (primero inicie sesión con tcc auth login). En el primer dispositivo, use el token de su enlace de invitación

Opciones

  • --invite — Token del enlace de invitación de proveedor (solo en el primer dispositivo)
  • --lang — Idioma del código: en | de | es | fr | it | nl. Por defecto, en

Sesión interactiva — una sesión persistente donde los comandos se escriben sin el prefijo tcc

Sellar contenido (demostrar que procede de usted)

Sellar el contenido del portapapeles

Opciones

  • --description — Owner-only description (1–120 characters), shown in your own seal list. Encrypted to your account key; nobody else sees it
  • --max-checks — End the seal after about this many checks by others (1–1000; 0 = no limit). Omitted: the suggestion of your plan
  • --require-approval — Exigir aprobación desde el teléfono antes de sellar
  • --show-my-name — Ignored: every seal shows your name and email address. Accepted for one release so existing scripts keep working
  • --valid-days — End the seal after this many days (1–3650; 0 = no limit). Omitted: the suggestion of your plan

Exportar un documento de prueba portátil de un sello

Argumentos

  • <id> — Seal ID (from list output)

Listar lo que esta cuenta ha sellado

Revocar un sello

Argumentos

  • <id> — Identificador del contenido (de la lista)

Sellar un texto escrito en la línea de comandos

Argumentos

  • <content> — The text to seal

Opciones

  • --description — Owner-only description (1–120 characters), shown in your own seal list. Encrypted to your account key; nobody else sees it
  • --file — Ruta del archivo que se incluye (resumido localmente, nunca se sube). Su nombre se cifra con el texto
  • --label — Título del sello. Se cifra con el texto (nunca se envía en claro) y se muestra en la pantalla de aprobación del teléfono
  • --language — Idioma de las palabras del código (en, de, fr, es, it, nl)
  • --max-checks — End the seal after about this many checks by others (1–1000; 0 = no limit). Omitted: the suggestion of your plan
  • --ref, -r — Dirección corta de referencia (puede repetirse)
  • --require-approval — Exigir aprobación desde el teléfono antes de sellar
  • --show-my-name — Ignored: every seal shows your name and email address. Accepted for one release so existing scripts keep working
  • --valid-days — End the seal after this many days (1–3650; 0 = no limit). Omitted: the suggestion of your plan

Sesiones activas — qué más tiene iniciada su sesión

Todas las sesiones iniciadas como usted

Cerrar una sesión

Argumentos

  • <session_id> — Identificador de la sesión (de tcc session list)

Configurar o cambiar de cuenta (entrar, registrar el dispositivo y sincronizar, todo a la vez)

Cambiar a otra cuenta (salir, entrar como otra persona, volver a configurar)

Sincronizar los secretos de las bóvedas con la caché local

Borrar los secretos en caché

Mostrar el estado de la sincronización

Ordenar las conexiones con etiquetas

Asignar una etiqueta a una conexión

Argumentos

  • <connection_id> — Identificador de la conexión
  • <tag_id> — Identificador de la etiqueta

Crear una etiqueta

Argumentos

  • <name> — Nombre de la etiqueta

Eliminar una etiqueta

Argumentos

  • <id> — Identificador de la etiqueta

Listar todas las etiquetas

Cambiar el nombre de una etiqueta

Argumentos

  • <id> — Identificador de la etiqueta
  • <name> — Nuevo nombre

Quitar una etiqueta de una conexión

Argumentos

  • <connection_id> — Identificador de la conexión
  • <tag_id> — Identificador de la etiqueta

Confianza — a quién sigue, su propia puntuación y el registro de verificaciones

Las personas a las que sigue

Seguir a alguien

Argumentos

  • <ticket> — El subscribeTicket que imprime tcc verify --public

Opciones

  • --description — Su propia nota
  • --label — Su propio nombre para esta persona
  • --source — De dónde procede el seguimiento

El historial de verificaciones de una persona a la que sigue

Argumentos

  • <watched_user_id> — Identificador de la persona a la que sigue (de tcc trust cards)

El registro de verificaciones

Opciones

  • --direction — Filtrar por dirección
  • --limit — Cuántas entradas devolver
  • --offset — Saltar este número de entradas

Cambiar su nombre o su nota para una persona a la que sigue

Argumentos

  • <watched_user_id> — Identificador de la persona a la que sigue (de tcc trust cards)

Opciones

  • --description — Nueva nota
  • --label — Nueva etiqueta

Su propia puntuación de confianza y las cifras que la sostienen

Dejar de seguir a alguien

Argumentos

  • <watched_user_id> — Identificador de la persona a la que sigue (de tcc trust cards)

Eliminar Trusted Codes por completo de este ordenador

Opciones

  • --confirm-last-key-holder — Quitar el dispositivo de este ordenador aunque sea el último que guarda la clave de la cuenta. Sin esta opción pregunta un terminal; sin terminal la ejecución se detiene antes de borrar nada en este ordenador
  • --delete-env-file — Eliminar también el archivo de entorno del operador (tcc.env) sin preguntar
  • --keep-device-on-server — Dejar activo en el servidor el dispositivo de este ordenador
  • --server-step — One account’s server step (internal: one child per account)
  • --yes — No preguntar; necesario cuando no hay terminal. Conserva el archivo de entorno

Quitar el punto de entrada tcc creado por install-cli

Verificar tres palabras contra las conexiones en caché

Argumentos

  • <word1> — Primera palabra
  • <word2> — Segunda palabra
  • <word3> — Tercera palabra

Opciones

  • --country — Indicación de país para la consulta pública (ISO 3166-1 alfa-2)
  • --public — Preguntar también al SERVIDOR (consulta pública). Las dos respuestas se imprimen por separado y nunca se mezclan: la comprobación local solo conoce los secretos que guarda este dispositivo, y decir «no coincide» cuando la respuesta honesta es «no puedo saberlo» es justo el error que conclusive evita