Tessera

Support

Tessera is open source and maintained on GitHub. The fastest way to report a bug or ask a question is to open an issue; for anything private, email works too.

Common questions

How do I import my existing accounts?

Export from Google Authenticator (Transfer accounts → Export) and scan the QR, or use the app's "Import file…" / paste box. In the CLI: tess import --qr export.png, or tess import --file accounts.txt for many otpauth links at once.

Where are my codes stored?

In an encrypted vault on your Mac. The app keeps it in its sandbox container; the CLI keeps it at ~/.local/share/tessera/vault.json. Point both at one file with the TESSERA_VAULT environment variable.

I forgot my passphrase.

The vault is end-to-end encrypted and cannot be recovered without the passphrase — that's the point. Keep an encrypted backup (tess export --file backup.json) and remember your passphrase.

Does it sync across devices?

Not yet. v1 is local-first; encrypted export/import lets you move a vault manually. Cross-device sync is planned.