Docs/Using Chervil

Passwords & payment cards

Chervil's encrypted, passphrase-locked vault for saved logins and payment cards โ€” how it stores them, how the ๐Ÿ”‘ and ๐Ÿ’ณ fill buttons work, and the security guarantees (never auto-submitted, never shown to Sprig, CVC never stored).

Chervil can save your logins and payment cards and fill them into real sites for you โ€” from one encrypted vault, protected by a single master passphrase. Sprig never sees any of it, and Chervil never submits a form or a payment for you.

The vault

Everything is stored in a local, encrypted vault. It's protected two ways at once:

  • Encrypted with AES-256-GCM under a key derived from your master passphrase (via scrypt). The passphrase is never stored โ€” if you forget it, there's no backdoor and no recovery.
  • Additionally wrapped with your OS keychain (Electron safeStorage), so the file is bound to your OS account too.

You set the master passphrase once, in Settings โ†’ Security, and enter it once per session to unlock. The vault auto-locks โ€” when Chervil is hidden to the tray, after an idle timeout you choose, or when you lock it by hand โ€” and asks for the passphrase again before it will fill anything.

Passwords and cards live in the same vault and share the one passphrase. Setting it up under Passwords unlocks both.

Saved logins โ€” the ๐Ÿ”‘ button

  • Save as you go. When you sign in to a site, Chervil offers to save the login. You can also add one by hand in Settings โ†’ Security โ†’ Passwords, and generate a strong password there.
  • Fill with one click. On a site where you have a saved login, click the ๐Ÿ”‘ button in the address bar, pick the login if there's more than one, and Chervil fills the username and password. It never submits โ€” you review and sign in yourself.
  • Logins are matched to the site's domain, so a saved GitHub login is only offered on GitHub.
  • Manage them like a password manager. In Settings โ†’ Security โ†’ Passwords you can search your logins (handy after importing hundreds), reveal or copy a password to the clipboard, and edit a login in place โ€” change the username or set a new password without deleting and re-adding it. Cards can be revealed and copied the same way.

Payment cards โ€” the ๐Ÿ’ณ button

Save cards to check out faster, with the same protection as your passwords.

  • Add a card in Settings โ†’ Security โ†’ Payment cards: the name on the card, the number, and the expiry. Numbers are validated (Luhn) on save. You can add a label like "Personal" to tell cards apart.
  • Fill at checkout. On a payment form, click the ๐Ÿ’ณ button, pick a card, and Chervil fills the cardholder name, number, and expiry โ€” handling combined MM / YY fields as well as separate month/year inputs and dropdowns.
  • The security code (CVC) is never stored. You type it yourself at checkout. This is deliberate โ€” it's the card-network best practice and keeps the most sensitive digit out of the vault entirely.
  • Chervil never auto-submits a payment. It fills the fields; you review the order and pay yourself.

Card listings only ever show the brand and last four digits (e.g. Visa ยทยทยทยท1234). The full number is decrypted only for a reveal in Settings or the moment it takes to fill a form โ€” never logged, and never placed in a prompt to Sprig or any AI model.

Show or hide the fill buttons

Don't want the ๐Ÿ”‘ or ๐Ÿ’ณ buttons in your address bar? Turn either off in Settings โ†’ Security โ€” the toggles sit right under the Passwords and Payment cards sections. They're shown by default, and only appear on real sites when you actually have something saved to fill.

What Chervil never does

  • Never shows your passwords or card numbers to Sprig or any model.
  • Never submits a login form or a payment โ€” you always do that yourself.
  • Never stores a card's CVC/security code.
  • Never writes any of this to the plaintext settings or session files โ€” only to the encrypted vault.