Aller au contenu

Référence des commandes

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

Cette page est générée à partir de l’analyseur de la ligne de commande ; elle ne peut donc pas contredire le programme. tcc <commande> --help affiche les mêmes informations dans le terminal.

180 commandes, 89 options. Les chevrons sont obligatoires, les crochets facultatifs.

Elles s’emploient avec n’importe quelle commande.

  • --account — Agir sous un autre compte de ce poste, pour cette commande seulement
  • --dry-run — Aperçu sans rien modifier (commandes modifiantes seulement)
  • --db, -e, --env — Quel serveur interroger (local/dev/prod)
  • --json, -j — Sortie en JSON (lisible par une machine)
  • --quiet, -q — Supprimer les sorties non essentielles
  • --server — Remplacer l’adresse du service tcc distant pour cet appel. Équivaut à la variable TCC_REMOTE_URL. Utile dans les scripts et l’intégration continue, où exporter des variables est malcommode. À utiliser avec --token
  • --token — Jeton d’API (tc_live_* / tc_test_*) pour le service distant. Équivaut à la variable d’environnement TCC_API_TOKEN. Obligatoire dès que --server est indiqué (ou son équivalent d’environnement)
  • --verbose, -v — Inclure la réponse complète de l’API dans la sortie

Les comptes de ce poste et le cycle de vie de ce compte

Supprimer ce compte et tout ce qu’il contient. IRRÉVERSIBLE

Retirer un compte de ce poste

Arguments

  • <id_or_email> — Identifiant du compte, ou l’adresse avec laquelle il se connecte

Lister les comptes connectés sur ce poste (par défaut)

Ouvrir une page du portail du compte, connecté (affiche un lien à usage unique)

Arguments

  • [target] — La page du portail, p. ex. account ou emails — Par défaut account

Changer le compte sous lequel ce poste agit

Arguments

  • <id_or_email> — Identifiant du compte, ou l’adresse avec laquelle il se connecte

Gérer les jetons d’API du serveur (pour l’accès programmatique)

Créer un jeton d’API du serveur

Arguments

  • <name> — Nom parlant (par exemple « chaîne CI »)

Options

  • --scopes — Droits séparés par des virgules (facultatif)

Lister tous les jetons d’API du serveur

Révoquer un jeton d’API du serveur par son identifiant

Arguments

  • <id> — Identifiant du jeton (issu de la liste)

Poser une question à l’assistant

Arguments

  • [message] — Votre question, par exemple « quel est le code de Mark »

Options

  • --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

Noter une réponse de l’assistant

Arguments

  • <chat_log_id> — L’identifiant que la réponse portait dans data.chatLogId
  • <rating> — utile | pas utile

Authentification (connexion, déconnexion, état)

Adopter une session lue sur l’entrée standard, sans navigateur

Se connecter : ouvre le navigateur, ou avec —code utilise le code du mail de connexion

Options

  • --code — Se connecter avec le code du mail de connexion au lieu du navigateur
  • --email — L’adresse à laquelle envoyer le code (demandée si elle manque)

Effacer les jetons du trousseau

Afficher l’état de la connexion

Afficher le jeton d’accès (utilisable dans un tube)

Opérations sur les codes à usage unique

Lister tous les codes

Indiquer quand le code change

Afficher le code actuel de trois mots d’un nom — connexion ou code invité

Arguments

  • <name> — Nom de la connexion ou libellé du code invité (un nom partiel suffit)

Options

  • --kind — Un seul type : connection ou guest
  • --lang — Langue différente de l’habituelle

Configuration

Retirer le service distant enregistré — les appels suivants passent par le service local (s’il tourne) ou en mode autonome

Créer un jeton d’API pour l’accès HTTP

Options

  • --label — Libellé du jeton (par exemple « claude-ai », « chatgpt »)
  • --scope — Droits du jeton : lecture, écriture ou complet
  • --ttl-hours — Durée de validité en heures (à omettre pour aucune expiration — local seulement)

Lister tous les jetons d’API (masqués)

Réinitialiser l’appareil — effacer les données de l’utilisateur et le réinscrire au prochain usage

Révoquer un jeton d’API par son libellé

Arguments

  • <label> — Libellé du jeton

Enregistrer un service tcc distant comme cible par défaut. Écrit dans ~/.config/tcc/config.toml et relu à chaque appel, sauf si --server ou TCC_REMOTE_URL le remplacent

Arguments

Options

  • --token — Jeton d’API (tc_live_* / tc_test_*) associé à cette adresse — obligatoire

Lire ou définir le raccourci clavier global de scellement. Exemple : tcc config shortcut “CmdOrCtrl+Shift+S”

Arguments

  • [value] — Nouveau raccourci (par exemple « CmdOrCtrl+Shift+S »). À omettre pour afficher l’actuel

Afficher la configuration actuelle

Afficher un jeton d’API par son libellé (valeur complète)

Arguments

  • <label> — Libellé du jeton

Afficher l’adresse du service distant enregistrée (jeton masqué)

Se connecter par un lien ouvert

Arguments

  • <slug> — Adresse courte du lien ouvert (par exemple « stefan/my-link »)

Gérer les connexions existantes

Ajouter un membre

Arguments

  • <email> — Adresse de la personne à ajouter
  • <id> — Identifiant de la connexion

Définir l’image de la connexion depuis un fichier local

Arguments

  • <id> — Identifiant de la connexion
  • <path> — Chemin vers un fichier JPEG, PNG, WEBP ou GIF

Changer le fonctionnement des codes d’identité de cette connexion

Arguments

  • <id> — Identifiant de la connexion
  • <mode> — Mode : dedicated (des mots propres à cette connexion) ou shared (tout le monde dans la connexion dit les mêmes mots)

Supprimer une connexion

Arguments

  • <id> — Identifiant de la connexion

Mettre ou retirer des favoris

Arguments

  • <id> — Identifiant de la connexion

Lister les connexions avec leurs étiquettes

Afficher les membres

Arguments

  • <id> — Identifiant de la connexion

Retirer l’image de la connexion

Arguments

  • <id> — Identifiant de la connexion

Retirer un membre

Arguments

  • <id> — Identifiant de la connexion
  • <member_id> — Identifiant du membre (issu de members)

Transférer la propriété à un autre membre

Arguments

  • <id> — Identifiant de la connexion
  • <new_owner_id> — Identifiant du nouveau propriétaire (issu de members)

Modifier les réglages de la connexion (nom, langue, rotation, description)

Arguments

  • <id> — Identifiant de la connexion

Options

  • --description — Description
  • --lang — Nouvelle langue
  • --name — Nouveau nom
  • --rotation-hours — Période de rotation en heures (par exemple 1, 6, 24, 168 pour hebdomadaire)

Service d’arrière-plan sans interface (serveurs Linux, CI)

Installer et activer comme service utilisateur systemd (Linux uniquement)

Démarrer le service (HTTP, serveur MCP et synchronisation)

Afficher l’état du service

Arrêter le service en cours

Gestion des appareils (inscription, récupération, état)

Tous les appareils connectés à ce COMPTE, pas seulement celui-ci

Saisir le code de récupération pour activer le chiffrement de bout en bout

Régénérer les mots de récupération (nouveaux mots, même clé)

Options

  • --lang — Langue des mots de récupération (en, de, es, fr, it, nl)

Générer la paire de clés et l’inscrire auprès du serveur

Déconnecter un appareil de ce compte

Arguments

  • <device_id> — Identifiant de l’appareil (issu de tcc device list)

Options

  • --confirm-last-key-holder — Le supprimer même s’il est le dernier appareil qui détient la clé du compte

Créer les mots de récupération (appareil premier ou unique)

Options

  • --lang — Langue des mots de récupération (en, de, es, fr, it, nl)

Afficher l’état d’inscription de l’appareil

Adresses de courrier de ce compte

Retirer une adresse

Arguments

  • <id> — Identifiant de l’adresse (issu de tcc email list)

Lister toutes les adresses de ce compte

Envoyer un code de vérification à une adresse

Arguments

  • <address> — L’adresse à vérifier

Choisir l’adresse que voient vos connexions

Arguments

  • <id> — Identifiant de l’adresse (issu de tcc email list)

Faire d’une adresse l’adresse principale

Arguments

  • <id> — Identifiant de l’adresse (issu de tcc email list)

Saisir le code envoyé à une adresse

Arguments

  • <address> — L’adresse
  • <code> — Le code reçu par courrier

Export de données — demander une copie de tout ce que ce compte détient

Retirer tous les exports demandés par ce compte

Obtenir un lien signé et expirant vers un export terminé

Arguments

  • <export_id> — Identifiant de l’export (issu de tcc export list)

Les exports demandés par ce compte, prêts ou non

Demander au serveur de préparer un export

Membres externes (accès web pour qui n’a pas l’application)

Ajouter un membre externe (sans application)

Arguments

  • <email> — Adresse de courrier
  • <name> — Nom de la personne

Options

  • --lang — Langue des mots du code
  • --tag — Nom personnalisé de la connexion

Lister tous les membres externes

Révoquer l’accès d’un membre externe

Arguments

  • <member_id> — Identifiant du membre

Envoyer un retour à l’équipe. Il part par courrier, d’où la ligne de commande seule

Arguments

  • <category> — anomalie | fonctionnalité | général
  • <message> — Ce que vous voulez dire (de 10 à 2000 caractères)

Options

  • --rating — Note facultative, de 1 à 5

Codes invité (pour qui n’a pas l’application)

Créer un code invité

Arguments

  • <name> — Nom de la personne

Options

  • --expires — Heures avant expiration
  • --lang — Langue des mots du code

Lister tous les codes invité

Produire un QR code pour un code invité

Arguments

  • <id> — Identifiant du code invité (issu de list ou create)

Révoquer un code invité

Arguments

  • <id> — Identifiant du code invité (issu de la liste)

Chercher des codes invité par nom

Arguments

  • <query> — Texte recherché

Envoyer un code invité par courrier

Arguments

  • <id> — Identifiant du code invité (issu de list ou create)

Options

  • --to — Adresse du destinataire — obligatoire

Placer tcc dans votre PATH pour que l’application et la ligne de commande soient un seul programme

Options

  • --force — Remplacer un tcc existant qui pointe ailleurs

Créer des connexions et gérer les invitations

Accepter une invitation qui vous est adressée

Arguments

  • <id> — Identifiant de l’invitation

Options

  • --force — Accepter bien que l’invitation indique une autre adresse

Accepter une invitation fédérée (une entrée poussée ici par un autre nœud)

Arguments

  • <id> — Identifiant de l’invitation en attente

Approuver la demande d’une autre personne de rejoindre une de vos connexions

Arguments

  • <id> — Identifiant de l’invitation

Refuser une invitation

Arguments

  • <id> — Identifiant de l’invitation

Refuser une invitation fédérée

Arguments

  • <id> — Identifiant de l’invitation en attente

Lister les invitations fédérées en attente pour ce compte

Lister toutes les invitations

Lister les demandes d’approbation en attente

Prolonger la validité d’une invitation en attente

Arguments

  • <id> — Identifiant de l’invitation

Créer une connexion et envoyer des invitations

Arguments

  • <name> — Nom de la connexion

Options

  • --duration — Suppression automatique après ce nombre d’heures (-1 = jamais)
  • --lang — Langue des mots du code
  • --message — Message personnel dans le courrier d’invitation
  • --tags — Étiquettes (séparées par des virgules)
  • --to — Adresse ou adresses de courrier, séparées par des virgules

Retirer une invitation envoyée

Arguments

  • <id> — Identifiant de l’invitation

Gérer les liens ouverts partageables

Approuver une demande

Arguments

  • <id> — Identifiant de la demande

Changer l’adresse du lien

Arguments

  • <id> — Identifiant du lien
  • <slug> — Nouvelle adresse courte

Créer un lien ouvert

Options

  • --approval — Mode d’approbation : automatique ou manuel
  • --slug — Adresse courte personnalisée

Refuser une demande

Arguments

  • <id> — Identifiant de la demande

Supprimer un lien

Arguments

  • <id> — Identifiant du lien

Lister tous les liens ouverts

Suspendre un lien

Arguments

  • <id> — Identifiant du lien

Lister les demandes de connexion en attente

Réactiver un lien

Arguments

  • <id> — Identifiant du lien

Proposer des noms de lien disponibles

Vérifier si une adresse de courrier est connue de Trusted Codes

Arguments

  • <email> — Adresse de courrier à vérifier

Intégration MCP avec les applications d’IA

Ajouter Trusted Codes à une application d’IA

Arguments

  • [app] — Application d’IA à configurer (claude-desktop, claude-code, cursor)

Retirer Trusted Codes d’une application d’IA

Arguments

  • <app> — Application d’IA dont on retire Trusted Codes (claude-desktop, claude-code, cursor)

Montrer quelles applications d’IA ont Trusted Codes configuré

Voir et gérer les notifications

Supprimer des notifications

Arguments

  • [ids] — Identifiants des notifications

Lister les notifications récentes

Options

  • --limit — Nombre maximal à afficher
  • --unread — N’afficher que les non lues

Marquer des notifications comme lues

Arguments

  • [ids] — Identifiants des notifications

Dans quelle organisation vous agissez, et comment en changer

Quelle organisation est active pour cette session, et ce qu’elle permet

Agir dans une organisation, ou revenir au contexte personnel

Arguments

  • [organization_id] — Identifiant de l’organisation. À omettre avec —personal pour annuler le choix

Options

  • --personal — Agir en votre nom plutôt que dans une organisation

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

Options

  • --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

Arguments

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

Deny the page that claimed your generator words

Arguments

  • <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

Options

  • --lang — Language of the three words

List your codes

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

Options

  • --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)

Arguments

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

Withdraw a code that is not used yet

Arguments

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

Ce que permet la formule de ce compte — fonctions, limites et choix

Options

  • --refresh — Interroger le serveur au lieu de répondre depuis la base locale

Voir et modifier les préférences de notification

Rétablir les valeurs par défaut

Activer ou désactiver un canal de notification

Arguments

  • <channel> — Canal : courrier, notification push ou dans l’application
  • <topic> — Sujet (par exemple invitation_received, security_alert)

Options

  • --enabled — Activé ou désactivé

Afficher les préférences de notification

Gérer les modèles de connexion

Créer un modèle

Arguments

  • <name> — Nom du modèle

Options

  • --duration — Heures avant suppression automatique
  • --lang — Langue par défaut

Supprimer un modèle

Arguments

  • <id> — Identifiant du modèle

Lister les modèles

Définir le modèle par défaut (sans identifiant, il est effacé)

Arguments

  • [id] — Identifiant du modèle (à omettre pour effacer le modèle par défaut)

Modifier un modèle

Arguments

  • <id> — Identifiant du modèle

Options

  • --duration — Nouveau délai avant suppression automatique, en heures
  • --lang — Nouvelle langue par défaut
  • --name — Nouveau nom

Voir ou modifier le profil

Afficher le profil (par défaut sans sous-commande)

Changer la langue préférée

Arguments

  • <language> — Code de langue (en, de, es, fr, it, nl)

Changer le nom affiché

Arguments

  • <name> — Nouveau nom affiché

Sceaux de fournisseur — produire depuis cet appareil des codes de provenance à usage unique

Lister les codes produits depuis ce compte

Produire un code à usage unique : affiche les trois mots et les copie dans le presse-papiers

Options

  • --lang — Langue du code : en | de | es | fr | it | nl. Par défaut en

Préparer CET appareil à produire des sceaux (connectez-vous d’abord avec tcc auth login). Sur le premier appareil, utilisez le jeton de votre lien d’invitation

Options

  • --invite — Jeton issu de votre lien d’invitation fournisseur (premier appareil seulement)
  • --lang — Langue du code : en | de | es | fr | it | nl. Par défaut en

Session interactive — une session durable où les commandes s’écrivent sans le préfixe tcc

Sceller un contenu (prouver qu’il vient de vous)

Sceller le contenu du presse-papiers

Options

  • --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 — Exiger une approbation depuis le téléphone avant de sceller
  • --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

Exporter un document de preuve portable pour un sceau

Arguments

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

Lister ce que ce compte a scellé

Révoquer un sceau

Arguments

  • <id> — Identifiant du contenu (issu de la liste)

Sceller un texte saisi sur la ligne de commande

Arguments

  • <content> — The text to seal

Options

  • --description — Owner-only description (1–120 characters), shown in your own seal list. Encrypted to your account key; nobody else sees it
  • --file — Chemin du fichier à inclure (haché localement, jamais téléversé). Son nom est chiffré avec le texte
  • --label — Titre du sceau. Chiffré avec le texte (jamais envoyé en clair) et affiché sur l’écran d’approbation du téléphone
  • --language — Langue des mots de code (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 — Adresse courte de référence (répétable)
  • --require-approval — Exiger une approbation depuis le téléphone avant de sceller
  • --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

Sessions actives — ce qui est connecté en votre nom

Toutes les sessions ouvertes en votre nom

Fermer une session

Arguments

  • <session_id> — Identifiant de la session (issu de tcc session list)

Configurer un compte ou en changer (connexion, inscription de l’appareil, synchronisation, d’un seul geste)

Passer à un autre compte (déconnexion, connexion sous un autre nom, reconfiguration)

Synchroniser les secrets des coffres vers le cache local

Effacer les secrets en cache

Afficher l’état de la synchronisation

Ranger les connexions avec des étiquettes

Attribuer une étiquette à une connexion

Arguments

  • <connection_id> — Identifiant de la connexion
  • <tag_id> — Identifiant de l’étiquette

Créer une étiquette

Arguments

  • <name> — Nom de l’étiquette

Supprimer une étiquette

Arguments

  • <id> — Identifiant de l’étiquette

Lister toutes les étiquettes

Renommer une étiquette

Arguments

  • <id> — Identifiant de l’étiquette
  • <name> — Nouveau nom

Retirer une étiquette d’une connexion

Arguments

  • <connection_id> — Identifiant de la connexion
  • <tag_id> — Identifiant de l’étiquette

Confiance — qui vous suivez, votre propre score et le journal des vérifications

Les personnes que vous suivez

Suivre quelqu’un

Arguments

  • <ticket> — Le subscribeTicket affiché par tcc verify --public

Options

  • --description — Votre propre note
  • --label — Votre propre nom pour cette personne
  • --source — D’où vient cet abonnement

L’historique des vérifications d’une personne que vous suivez

Arguments

  • <watched_user_id> — Identifiant de la personne que vous suivez (issu de tcc trust cards)

Le journal des vérifications

Options

  • --direction — Filtrer par sens
  • --limit — Nombre d’entrées à renvoyer
  • --offset — Ignorer ce nombre d’entrées

Modifier votre nom ou votre note pour une personne que vous suivez

Arguments

  • <watched_user_id> — Identifiant de la personne que vous suivez (issu de tcc trust cards)

Options

  • --description — Nouvelle note
  • --label — Nouveau libellé

Votre propre score de confiance et les chiffres qui le composent

Ne plus suivre quelqu’un

Arguments

  • <watched_user_id> — Identifiant de la personne que vous suivez (issu de tcc trust cards)

Supprimer complètement Trusted Codes de cet ordinateur

Options

  • --confirm-last-key-holder — Supprimer l’appareil de cet ordinateur même s’il est le dernier appareil qui détient la clé du compte. Sans ce paramètre, un terminal demande ; sans terminal, l’exécution s’arrête avant toute suppression sur cet ordinateur
  • --delete-env-file — Supprimer aussi le fichier d’environnement de l’opérateur (tcc.env) sans demander
  • --keep-device-on-server — Laisser actif sur le serveur l’appareil de cet ordinateur
  • --server-step — One account’s server step (internal: one child per account)
  • --yes — Ne pas demander ; nécessaire sans terminal. Conserve le fichier d’environnement

Retirer le point d’entrée tcc créé par install-cli

Vérifier trois mots contre les connexions en cache

Arguments

  • <word1> — Premier mot
  • <word2> — Deuxième mot
  • <word3> — Troisième mot

Options

  • --country — Indication de pays pour la recherche publique (ISO 3166-1 alpha-2)
  • --public — Interroger aussi le SERVEUR (recherche publique). Les deux réponses sont affichées séparément et jamais fusionnées : la vérification locale ne connaît que les secrets détenus par cet appareil, et répondre « aucune correspondance » quand la réponse honnête est « je ne peux pas savoir » est précisément l’erreur que conclusive évite