Command reference

Every command is tcc <verb> [subcommand] [arguments] [flags]. Angle brackets are required arguments; square brackets are optional. tcc <verb> --help prints the same information at the terminal.

Global Flags

These work on any command.

• --json, -j — machine-readable output.
• --quiet, -q — suppress everything that is not the answer.
• --verbose, -v — include the full API response.
• --dry-run — preview a change without making it. Only affects commands that change something.
• --server <url> and --token <token> — send this command to a daemon on another machine. See The daemon.

Account and Device

• tcc setup — sign in, register this device, sync. The whole first run.
• tcc switch — sign out, sign in as somebody else, set up again. Clears this machine’s cached data.
• tcc auth login | logout | status | token
• tcc device register | status | list
• tcc device remove <device-id>
• tcc device recover — enter recovery words on a new device.
• tcc device setup-recovery [--lang <code>] — create recovery words.
• tcc device regenerate-recovery [--lang <code>] — new words, same key.
• tcc sync — download secrets, upload any a peer is missing.
• tcc sync status | clear
• tcc profile — show your profile.
• tcc profile set-name <name>
• tcc profile set-language <code>
• tcc email list
• tcc email send <address> — send a verification code to an address.
• tcc email verify <address> <code>
• tcc email set-primary <id> · tcc email set-display <id> · tcc email delete <id>
• tcc session list — everything signed in as you.
• tcc session revoke <session-id>
• tcc export request | list | delete-all
• tcc export download <export-id> — a signed, expiring link to a finished export. Exports are built in the background, so request answers with an id, not a file.
• tcc account delete — deletes the account and everything in it. Irreversible. Asks you to type the account’s own address at the terminal first, and sends nothing until it matches.

Language codes throughout are en, de, es, fr, it and nl.

Codes and Verification

• tcc code show [name] [--lang <code>] — your personal code, or a connection’s.
• tcc code list — every code this device can compute.
• tcc code next — the current window and the next rotation.
• tcc verify <word1> <word2> <word3> [--public] [--country <cc>]
• tcc lookup <email> — is this address on Trusted Codes.

Seals

• tcc stamp text <content> with --file <path>, --email <address>, --language <code>, --label <text>, --require-approval, --ref <slug> (repeatable).
• tcc stamp clipboard [--require-approval]
• tcc stamp self [--language <code>] [--description <text>]
• tcc stamp list · tcc stamp export <id> · tcc stamp revoke <id>

Connections

• tcc invite send <name> --to <email> — create a connection and invite people. Give --to once per address to invite more than one. Also --lang, --duration <hours> (-1 never), --tags, --message.
• tcc invite list | pending
• tcc invite approve <id> · decline <id> · withdraw <id> · renew <id>
• tcc connection list
• tcc connection update <id> with --name, --lang, --rotation-hours, --description.
• tcc connection code-mode <id> <mode> — personal, per_contact or dedicated.
• tcc connection members <id> · add-member <id> <email> · remove-member <id> <member-id>
• tcc connection favorite <id> · avatar <id> <url> · remove-avatar <id>
• tcc connection transfer <id> <new-owner-id> — hand ownership to another member.
• tcc connection delete <id>
• tcc tag list · create <name> · rename <id> <name> · delete <id>
• tcc tag assign <tag-id> <connection-id> · unassign <tag-id> <connection-id>
• tcc preset list · create <name> [--lang] [--duration] · update <id> · delete <id> · set-default [id] (omit the id to clear it)

People Without the App

• tcc guest create <name> [--expires <hours>] [--lang <code>]
• tcc guest list · search <query> · revoke <id>
• tcc guest send <id> --to <email> · tcc guest qr <id>
• tcc external add <name> <email> [--lang <code>] [--tag <name>]
• tcc external list · tcc external revoke <member-id>

Open Links

• tcc link create [--slug <slug>] [--approval auto|manual]
• tcc link list · pause <id> · resume <id> · delete <id>
• tcc link change-slug <id> <slug> · tcc link suggest-slugs
• tcc link requests · approve <id> · decline <id>
• tcc connect <slug> — connect through somebody else’s open link.

Trust

• tcc trust score — your own score and the numbers behind it.
• tcc trust cards — the people you follow.
• tcc trust follow <ticket> [--label] [--description] [--source] — the ticket comes from tcc verify --public; a public verification is the only thing that issues one.
• tcc trust rename <watched-user-id> [--label] [--description]
• tcc trust unfollow <watched-user-id> · tcc trust history <watched-user-id>
• tcc trust log [--offset <n>] [--limit <n>] [--direction <d>]

Notifications

• tcc notify list [--limit <n>] [--unread] — 20 by default.
• tcc notify read <ids…> · tcc notify delete <ids…>
• tcc prefs show · tcc prefs reset
• tcc prefs set <topic> <channel> --enabled <true|false> — channel is email, push or in_app.

Organisations

Organisation commands act in one organisation at a time. On an account with no default organisation, set it first — otherwise the others answer that there is no organisation to act in.

• tcc org use <organization-id> · tcc org use --personal
• tcc org current — which organisation is active, and what it allows.
• tcc org members [--org-id <id>] · tcc org member <id>
• tcc org suspend <id> · tcc org activate <id>
• tcc org bulk-invite <emails> [--group-id <id>] — comma-separated addresses.
• tcc org groups · create-group <name> [--description] · update-group <id> [--name] [--description] · delete-group <id>
• tcc org group-add <group-id> <member-ids> · group-remove <group-id> <member-ids>
• tcc org group-entitlements <group-id> --entitlements <json>
• tcc org alerts · create-alert <metric-key> <threshold-pct> [--notify-roles] · update-alert <id> [--threshold-pct] [--notify-roles] [--enabled] · delete-alert <id>
• tcc org dashboard · activity · activity-summary · trends
• tcc org usage <user-id> · tcc org group-usage <group-id>
• tcc org transfer <new-owner-id> — the server refuses while the current owner still has active members.
• tcc org reassign-customers <from-owner-id> <to-owner-id>

Most of these accept --org-id to name the organisation explicitly instead of using the active one.

Provider Codes

For accounts that mint one-time provenance codes — a bank confirming that a call really is from the bank.

• tcc provider provision [--invite <token>] [--lang <code>] — set this device up. The invite token comes from your provider invitation link and is needed on the first device only.
• tcc provider mint [--lang <code>] — mint one code. Prints the words and copies them to the clipboard.
• tcc provider history — the codes this account has created.

Daemon, Configuration and Integrations

• tcc daemon start | stop | status
• tcc daemon install-service — systemd user service, Linux only.
• tcc config show · tcc config reset-device
• tcc config create-api-token [--label <name>] [--scope read|write|full] [--ttl-hours <n>]
• tcc config list-api-tokens · show-api-token <label> · revoke-api-token <label>
• tcc config set-remote <url> --token <token> · show-remote · clear-remote
• tcc config shortcut ["CmdOrCtrl+Shift+S"] — the global keyboard shortcut for signing. Omit the value to see the current one.
• tcc api-token generate <name> [--scopes <list>] · tcc api-token list · tcc api-token revoke <id> — tokens for the platform, not for the local daemon.
• tcc mcp status · configure [app] · remove <app> — claude-desktop, claude-code or cursor.
• tcc tray · tcc tray stop · tcc tray status — the system tray application. Desktop installs only; the server build has no such command.

Assistant and Feedback

• tcc ask "<question>" — ask the assistant one question.
• tcc ask-rate <chat-log-id> helpful|not_helpful — the id comes back with the answer.
• tcc feedback <bug|feature|general> "<message>" [--rating <1-5>] — 10 to 2000 characters. This emails the team.