Salta ai contenuti

Riferimento dei comandi

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

Questa pagina è generata dal parser della riga di comando, quindi non può contraddire il programma. tcc <comando> --help mostra le stesse informazioni nel terminale.

180 comandi, 89 opzioni. Le parentesi angolari sono obbligatorie, quelle quadre facoltative.

Si possono indicare su qualsiasi comando.

  • --account — Agire come un altro account di questo computer, solo per questo comando
  • --dry-run — Anteprima senza modificare nulla (solo per i comandi che modificano)
  • --db, -e, --env — Con quale server parlare (local/dev/prod)
  • --json, -j — Risposta in JSON (leggibile da una macchina)
  • --quiet, -q — Sopprimere le risposte non essenziali
  • --server — Sostituire l’indirizzo del servizio tcc remoto per questa chiamata. Corrisponde alla variabile TCC_REMOTE_URL. Utile negli script e nella CI, dove esportare variabili è scomodo. Da usare insieme a --token
  • --token — Token API (tc_live_* / tc_test_*) per il servizio remoto. Corrisponde alla variabile d’ambiente TCC_API_TOKEN. Obbligatorio ogni volta che si indica --server (o il suo equivalente d’ambiente)
  • --verbose, -v — Includere nella risposta l’intero responso dell’API

Gli account su questo computer e il ciclo di vita di questo account

Eliminare questo account e tutto ciò che contiene. IRREVERSIBILE

Rimuovere un account da questo computer

Argomenti

  • <id_or_email> — Identificativo dell’account, o l’indirizzo con cui accede

Elencare gli account con accesso su questo computer (predefinito)

Aprire una pagina del portale dell’account, con accesso (mostra un link monouso)

Argomenti

  • [target] — La pagina del portale, ad es. account o emails — Predefinito account

Cambiare l’account con cui agisce questo computer

Argomenti

  • <id_or_email> — Identificativo dell’account, o l’indirizzo con cui accede

Gestire i token API del server (per l’accesso programmatico)

Creare un token API del server

Argomenti

  • <name> — Nome descrittivo (per esempio «catena CI»)

Opzioni

  • --scopes — Permessi separati da virgole (facoltativo)

Elencare tutti i token API del server

Revocare un token API del server tramite il suo identificativo

Argomenti

  • <id> — Identificativo del token (dall’elenco)

Porre una domanda all’assistente

Argomenti

  • [message] — La domanda, per esempio «qual è il codice di Mark»

Opzioni

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

Valutare una risposta dell’assistente

Argomenti

  • <chat_log_id> — L’identificativo che la risposta portava in data.chatLogId
  • <rating> — utile | non utile

Autenticazione (accesso, uscita, stato)

Adottare una sessione letta dallo standard input, senza browser

Accedere: apre il browser, oppure con —code usa il codice della mail di accesso

Opzioni

  • --code — Accedere con il codice della mail di accesso invece che con il browser
  • --email — L’indirizzo a cui inviare il codice (richiesto se manca)

Cancellare i token dal portachiavi

Mostrare lo stato dell’accesso

Stampare il token di accesso (adatto alle pipe)

Operazioni sui codici monouso

Elencare tutti i codici

Indicare quando cambia il codice

Mostrare il codice attuale di tre parole di un nome: connessione o codice ospite

Argomenti

  • <name> — Nome della connessione o etichetta del codice ospite (basta una parte)

Opzioni

  • --kind — Un solo tipo: connection o guest
  • --lang — Lingua diversa da quella abituale

Configurazione

Rimuovere il servizio remoto memorizzato — le chiamate successive usano il servizio locale (se attivo) o la modalità autonoma

Creare un token API per l’accesso HTTP

Opzioni

  • --label — Etichetta del token (per esempio «claude-ai», «chatgpt»)
  • --scope — Permessi del token: lettura, scrittura o completi
  • --ttl-hours — Validità in ore (da omettere per nessuna scadenza — solo in locale)

Elencare tutti i token API (mascherati)

Reimpostare il dispositivo — cancellare i dati dell’utente e registrarlo di nuovo al prossimo uso

Revocare un token API tramite la sua etichetta

Argomenti

  • <label> — Etichetta del token

Memorizzare un servizio tcc remoto come destinazione predefinita. Scrive in ~/.config/tcc/config.toml e viene letto a ogni invocazione, salvo che --server o TCC_REMOTE_URL lo sostituiscano

Argomenti

Opzioni

  • --token — Token API (tc_live_* / tc_test_*) abbinato a questo indirizzo — obbligatorio

Leggere o impostare la scorciatoia da tastiera globale per sigillare. Esempio: tcc config shortcut “CmdOrCtrl+Shift+S”

Argomenti

  • [value] — Nuova scorciatoia (per esempio «CmdOrCtrl+Shift+S»). Da omettere per vedere quella attuale

Mostrare la configurazione attuale

Mostrare un token API tramite la sua etichetta (valore completo)

Argomenti

  • <label> — Etichetta del token

Stampare l’indirizzo memorizzato del servizio remoto (token mascherato)

Collegarsi tramite un link aperto

Argomenti

  • <slug> — Indirizzo breve del link aperto (per esempio «stefan/my-link»)

Gestire le connessioni esistenti

Aggiungere un membro

Argomenti

  • <email> — Indirizzo della persona da aggiungere
  • <id> — Identificativo della connessione

Impostare l’immagine della connessione da un file locale

Argomenti

  • <id> — Identificativo della connessione
  • <path> — Percorso di un file JPEG, PNG, WEBP o GIF

Cambiare il funzionamento dei codici di identità di questa connessione

Argomenti

  • <id> — Identificativo della connessione
  • <mode> — Modalità: dedicated (parole solo per questa connessione) o shared (tutti nella connessione dicono le stesse parole)

Eliminare una connessione

Argomenti

  • <id> — Identificativo della connessione

Aggiungere o togliere dai preferiti

Argomenti

  • <id> — Identificativo della connessione

Elencare le connessioni con le loro etichette

Mostrare i membri

Argomenti

  • <id> — Identificativo della connessione

Togliere l’immagine della connessione

Argomenti

  • <id> — Identificativo della connessione

Rimuovere un membro

Argomenti

  • <id> — Identificativo della connessione
  • <member_id> — Identificativo del membro (da members)

Trasferire la proprietà a un altro membro

Argomenti

  • <id> — Identificativo della connessione
  • <new_owner_id> — Identificativo del nuovo proprietario (da members)

Modificare le impostazioni della connessione (nome, lingua, rotazione, descrizione)

Argomenti

  • <id> — Identificativo della connessione

Opzioni

  • --description — Descrizione
  • --lang — Nuova lingua
  • --name — Nuovo nome
  • --rotation-hours — Periodo di rotazione in ore (per esempio 1, 6, 24, 168 per settimanale)

Servizio in background senza interfaccia (server Linux, CI)

Installare e attivare come servizio utente systemd (solo Linux)

Avviare il servizio (HTTP, server MCP e sincronizzazione)

Mostrare lo stato del servizio

Fermare il servizio in esecuzione

Gestione dei dispositivi (registrazione, recupero, stato)

Ogni dispositivo con accesso a questo ACCOUNT, non solo questo

Inserire il codice di recupero per attivare la cifratura end-to-end

Rigenerare le parole di recupero (parole nuove, stessa chiave)

Opzioni

  • --lang — Lingua delle parole di recupero (en, de, es, fr, it, nl)

Generare la coppia di chiavi e registrarla presso il server

Disconnettere un dispositivo da questo account

Argomenti

  • <device_id> — Identificativo del dispositivo (da tcc device list)

Opzioni

  • --confirm-last-key-holder — Rimuoverlo anche se è l’ultimo dispositivo che conserva la chiave dell’account

Creare le parole di recupero (dispositivo primo o unico)

Opzioni

  • --lang — Lingua delle parole di recupero (en, de, es, fr, it, nl)

Mostrare lo stato di registrazione del dispositivo

Indirizzi di posta di questo account

Rimuovere un indirizzo

Argomenti

  • <id> — Identificativo dell’indirizzo (da tcc email list)

Elencare tutti gli indirizzi di questo account

Inviare un codice di verifica a un indirizzo

Argomenti

  • <address> — L’indirizzo da verificare

Scegliere l’indirizzo che vedono le sue connessioni

Argomenti

  • <id> — Identificativo dell’indirizzo (da tcc email list)

Rendere principale un indirizzo

Argomenti

  • <id> — Identificativo dell’indirizzo (da tcc email list)

Inserire il codice inviato a un indirizzo

Argomenti

  • <address> — L’indirizzo
  • <code> — Il codice ricevuto per posta

Esportazione dei dati — chiedere una copia di tutto ciò che questo account conserva

Rimuovere ogni esportazione richiesta da questo account

Ottenere un link firmato e a scadenza per un’esportazione completata

Argomenti

  • <export_id> — Identificativo dell’esportazione (da tcc export list)

Le esportazioni richieste da questo account, pronte o no

Chiedere al server di preparare un’esportazione

Membri esterni (accesso web per chi non ha l’applicazione)

Aggiungere un membro esterno (senza applicazione)

Argomenti

  • <email> — Indirizzo di posta
  • <name> — Nome della persona

Opzioni

  • --lang — Lingua delle parole del codice
  • --tag — Nome personalizzato della connessione

Elencare tutti i membri esterni

Revocare l’accesso di un membro esterno

Argomenti

  • <member_id> — Identificativo del membro

Inviare un riscontro al team. Viene spedito per posta, perciò esiste solo sulla riga di comando

Argomenti

  • <category> — errore | funzione | generale
  • <message> — Ciò che vuole dire (da 10 a 2000 caratteri)

Opzioni

  • --rating — Valutazione facoltativa, da 1 a 5

Codici ospite (per chi non ha l’applicazione)

Creare un codice ospite

Argomenti

  • <name> — Nome della persona

Opzioni

  • --expires — Ore prima della scadenza
  • --lang — Lingua delle parole del codice

Elencare tutti i codici ospite

Generare un codice QR per un codice ospite

Argomenti

  • <id> — Identificativo del codice ospite (da list o create)

Revocare un codice ospite

Argomenti

  • <id> — Identificativo del codice ospite (dall’elenco)

Cercare i codici ospite per nome

Argomenti

  • <query> — Testo da cercare

Inviare un codice ospite per posta

Argomenti

  • <id> — Identificativo del codice ospite (da list o create)

Opzioni

  • --to — Indirizzo del destinatario — obbligatorio

Mettere tcc nel suo PATH, così l’applicazione e la riga di comando sono un solo programma

Opzioni

  • --force — Sostituire un tcc esistente che punta altrove

Creare connessioni e gestire gli inviti

Accettare un invito indirizzato a lei

Argomenti

  • <id> — Identificativo dell’invito

Opzioni

  • --force — Accettare benché l’invito indichi un altro indirizzo

Accettare un invito federato (una voce inviata qui da un altro nodo)

Argomenti

  • <id> — Identificativo dell’invito in sospeso

Approvare la richiesta di un’altra persona di entrare in una sua connessione

Argomenti

  • <id> — Identificativo dell’invito

Rifiutare un invito

Argomenti

  • <id> — Identificativo dell’invito

Rifiutare un invito federato

Argomenti

  • <id> — Identificativo dell’invito in sospeso

Elencare gli inviti federati in attesa per questo account

Elencare tutti gli inviti

Elencare le richieste di approvazione in sospeso

Prolungare la validità di un invito in sospeso

Argomenti

  • <id> — Identificativo dell’invito

Creare una connessione e inviare inviti

Argomenti

  • <name> — Nome della connessione

Opzioni

  • --duration — Cancellazione automatica dopo queste ore (-1 = mai)
  • --lang — Lingua delle parole del codice
  • --message — Messaggio personale nella posta di invito
  • --tags — Etichette (separate da virgole)
  • --to — Indirizzo o indirizzi di posta, separati da virgole

Ritirare un invito inviato

Argomenti

  • <id> — Identificativo dell’invito

Gestire i link aperti condivisibili

Approvare una richiesta

Argomenti

  • <id> — Identificativo della richiesta

Cambiare l’indirizzo del link

Argomenti

  • <id> — Identificativo del link
  • <slug> — Nuovo indirizzo breve

Creare un link aperto

Opzioni

  • --approval — Modalità di approvazione: automatica o manuale
  • --slug — Indirizzo breve personalizzato

Rifiutare una richiesta

Argomenti

  • <id> — Identificativo della richiesta

Eliminare un link

Argomenti

  • <id> — Identificativo del link

Elencare tutti i link aperti

Sospendere un link

Argomenti

  • <id> — Identificativo del link

Elencare le richieste di connessione in sospeso

Riattivare un link

Argomenti

  • <id> — Identificativo del link

Proporre nomi di link disponibili

Controllare se un indirizzo di posta è noto a Trusted Codes

Argomenti

  • <email> — Indirizzo di posta da controllare

Integrazione MCP con le applicazioni di IA

Aggiungere Trusted Codes a un’applicazione di IA

Argomenti

  • [app] — Applicazione di IA da configurare (claude-desktop, claude-code, cursor)

Togliere Trusted Codes da un’applicazione di IA

Argomenti

  • <app> — Applicazione di IA da cui rimuovere Trusted Codes (claude-desktop, claude-code, cursor)

Mostrare quali applicazioni di IA hanno Trusted Codes configurato

Vedere e gestire le notifiche

Eliminare notifiche

Argomenti

  • [ids] — Identificativi delle notifiche

Elencare le notifiche recenti

Opzioni

  • --limit — Numero massimo da mostrare
  • --unread — Mostrare solo le non lette

Segnare le notifiche come lette

Argomenti

  • [ids] — Identificativi delle notifiche

In quale organizzazione agisce e come passare da una all’altra

Quale organizzazione è attiva in questa sessione e che cosa permette

Agire in un’organizzazione, o tornare al contesto personale

Argomenti

  • [organization_id] — Identificativo dell’organizzazione. Da omettere insieme a —personal per annullare la scelta

Opzioni

  • --personal — Agire a proprio nome anziché dentro un’organizzazione

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

Opzioni

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

Argomenti

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

Deny the page that claimed your generator words

Argomenti

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

Opzioni

  • --lang — Language of the three words

List your codes

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

Opzioni

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

Argomenti

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

Withdraw a code that is not used yet

Argomenti

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

Che cosa permette il piano di questo account — funzioni, limiti e scelte

Opzioni

  • --refresh — Interrogare il server anziché rispondere dal database locale

Vedere e cambiare le preferenze di notifica

Ripristinare i valori predefiniti

Attivare o disattivare un canale di notifica

Argomenti

  • <channel> — Canale: posta, notifica push o dentro l’applicazione
  • <topic> — Argomento (per esempio invitation_received, security_alert)

Opzioni

  • --enabled — Attivo o disattivo

Mostrare le preferenze di notifica

Gestire i modelli di connessione

Creare un modello

Argomenti

  • <name> — Nome del modello

Opzioni

  • --duration — Ore prima della cancellazione automatica
  • --lang — Lingua predefinita

Eliminare un modello

Argomenti

  • <id> — Identificativo del modello

Elencare i modelli

Impostare il modello predefinito (senza identificativo viene azzerato)

Argomenti

  • [id] — Identificativo del modello (da omettere per azzerare quello predefinito)

Modificare un modello

Argomenti

  • <id> — Identificativo del modello

Opzioni

  • --duration — Nuove ore prima della cancellazione automatica
  • --lang — Nuova lingua predefinita
  • --name — Nuovo nome

Vedere o modificare il profilo

Mostrare il profilo (predefinito se non si indica un sottocomando)

Cambiare la lingua preferita

Argomenti

  • <language> — Codice di lingua (en, de, es, fr, it, nl)

Cambiare il nome mostrato

Argomenti

  • <name> — Nuovo nome mostrato

Sigilli del fornitore — creare da questo dispositivo codici di provenienza monouso

Elencare i codici creati da questo account

Creare un codice monouso: stampa le tre parole e le copia negli appunti

Opzioni

  • --lang — Lingua del codice: en | de | es | fr | it | nl. Predefinita: en

Preparare QUESTO dispositivo a creare sigilli (prima acceda con tcc auth login). Sul primo dispositivo usi il token del suo link di invito

Opzioni

  • --invite — Token dal suo link di invito come fornitore (solo sul primo dispositivo)
  • --lang — Lingua del codice: en | de | es | fr | it | nl. Predefinita: en

Sessione interattiva — una sessione persistente in cui i comandi si scrivono senza il prefisso tcc

Sigillare un contenuto (dimostrare che viene da lei)

Sigillare il contenuto degli appunti

Opzioni

  • --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 — Richiedere l’approvazione dal telefono prima di sigillare
  • --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

Esportare un documento di prova portabile per un sigillo

Argomenti

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

Elencare ciò che questo account ha sigillato

Revocare un sigillo

Argomenti

  • <id> — Identificativo del contenuto (dall’elenco)

Sigillare un testo scritto sulla riga di comando

Argomenti

  • <content> — The text to seal

Opzioni

  • --description — Owner-only description (1–120 characters), shown in your own seal list. Encrypted to your account key; nobody else sees it
  • --file — Percorso del file da includere (hash calcolato in locale, mai caricato). Il suo nome viene cifrato con il testo
  • --label — Titolo del sigillo. Cifrato con il testo (mai inviato in chiaro) e mostrato sulla schermata di approvazione del telefono
  • --language — Lingua delle parole del codice (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 — Indirizzo breve di riferimento (ripetibile)
  • --require-approval — Richiedere l’approvazione dal telefono prima di sigillare
  • --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

Sessioni attive — che altro risulta collegato a suo nome

Ogni sessione aperta a suo nome

Chiudere una sessione

Argomenti

  • <session_id> — Identificativo della sessione (da tcc session list)

Configurare o cambiare account (accesso, registrazione del dispositivo e sincronizzazione in un solo passo)

Passare a un altro account (uscire, accedere come un’altra persona, riconfigurare)

Sincronizzare i segreti delle casseforti nella cache locale

Cancellare i segreti in cache

Mostrare lo stato della sincronizzazione

Ordinare le connessioni con le etichette

Assegnare un’etichetta a una connessione

Argomenti

  • <connection_id> — Identificativo della connessione
  • <tag_id> — Identificativo dell’etichetta

Creare un’etichetta

Argomenti

  • <name> — Nome dell’etichetta

Eliminare un’etichetta

Argomenti

  • <id> — Identificativo dell’etichetta

Elencare tutte le etichette

Rinominare un’etichetta

Argomenti

  • <id> — Identificativo dell’etichetta
  • <name> — Nuovo nome

Togliere un’etichetta da una connessione

Argomenti

  • <connection_id> — Identificativo della connessione
  • <tag_id> — Identificativo dell’etichetta

Fiducia — chi segue, il suo punteggio e il registro delle verifiche

Le persone che segue

Seguire una persona

Argomenti

  • <ticket> — Il subscribeTicket stampato da tcc verify --public

Opzioni

  • --description — La sua nota
  • --label — Il suo nome per questa persona
  • --source — Da dove proviene il collegamento

La cronologia delle verifiche di una persona che segue

Argomenti

  • <watched_user_id> — Identificativo della persona che segue (da tcc trust cards)

Il registro delle verifiche

Opzioni

  • --direction — Filtrare per direzione
  • --limit — Quante voci restituire
  • --offset — Saltare questo numero di voci

Modificare il suo nome o la sua nota per una persona che segue

Argomenti

  • <watched_user_id> — Identificativo della persona che segue (da tcc trust cards)

Opzioni

  • --description — Nuova nota
  • --label — Nuova etichetta

Il suo punteggio di fiducia e i numeri che lo compongono

Smettere di seguire una persona

Argomenti

  • <watched_user_id> — Identificativo della persona che segue (da tcc trust cards)

Rimuovere completamente Trusted Codes da questo computer

Opzioni

  • --confirm-last-key-holder — Rimuovere il dispositivo di questo computer anche se è l’ultimo che conserva la chiave dell’account. Senza l’opzione chiede un terminale; senza terminale l’esecuzione si ferma prima di eliminare qualcosa su questo computer
  • --delete-env-file — Eliminare anche il file di ambiente dell’operatore (tcc.env) senza chiedere
  • --keep-device-on-server — Lasciare attivo sul server il dispositivo di questo computer
  • --server-step — One account’s server step (internal: one child per account)
  • --yes — Non chiedere; necessario quando non c’è un terminale. Mantiene il file di ambiente

Togliere il punto di ingresso tcc creato da install-cli

Verificare tre parole rispetto alle connessioni in cache

Argomenti

  • <word1> — Prima parola
  • <word2> — Seconda parola
  • <word3> — Terza parola

Opzioni

  • --country — Indicazione di paese per la ricerca pubblica (ISO 3166-1 alpha-2)
  • --public — Interrogare anche il SERVER (ricerca pubblica). Le due risposte sono stampate separatamente e mai unite: il controllo locale conosce solo i segreti custoditi da questo dispositivo, e rispondere «nessuna corrispondenza» quando la risposta onesta è «non posso saperlo» è proprio l’errore che conclusive evita