Skip to content

Support

Help, and how it works.

The fastest way to report a bug or ask a question is a GitHub issue; for anything private, email works. New to two-factor codes? Start on /learn.
Tessera's main window: a sidebar with All, Pinned and a Work folder, and five accounts with live codes and countdown rings Tessera's main window: a sidebar with All, Pinned and a Work folder, and five accounts with live codes and countdown rings

Common questions

How do I import my existing accounts?

From Google Authenticator: Transfer accounts, Export, then scan the QR (app) or run tess import --migration "otpauth-migration://…". You can also paste otpauth links, or import a file of many at once, including Aegis, 2FAS and Raivo exports.

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. To use one vault for both, choose Open existing vault in the app and pick the CLI's file; the app remembers it.

I forgot my passphrase.

The vault cannot be decrypted without it. Keep a backup with tess export --file backup.json and store your passphrase somewhere safe, like a password manager.

Can I use it on more than one Mac?

Yes. Move a vault between machines with tess export --file backup.json, then tess merge backup.json on the other side. For the CLI to open the app's own vault, set a recovery passphrase in the app's settings, then point TESSERA_VAULT or --vault at that file.

Is it really free?

Yes. Apache-2.0 licensed, nothing to buy.

Which services work with Tessera?

Any service that offers an authenticator app (TOTP), plus HOTP and Steam Guard. If you can scan its QR or copy its setup link, Tessera can hold it.

Is there a menu bar mode?

Not in 1.0. Tessera is a windowed app; a status bar item is planned.