Stores

A store holds named values. The usual kind is a keychain, where every value is encrypted and stays hidden until you ask to see it. Use one for passwords, API keys, recovery codes and anything else you'd rather not keep in a note.

Make a keychain

On Desk, choose New, then Store. You get an empty keychain called Untitled Keychain, locked with your vault. The header shows the store's kind, how many entries it holds and whether it is locked.

Add an entry

Add opens a short form:

FieldWhat it's for
KeyThe entry's name, like github-token. Required
LabelA friendlier name to show in the list. Optional
ValueThe secret itself. Required
KindSecret, Password, API Token, Key Pair, Certificate, Config or Text
ServiceWhat the entry belongs to, like github. Optional

Add & Encrypt encrypts the value before it is saved. The entry shows its label, or its key if it has no label, with the service beside it.

See, copy and remove values

  • Tap a masked value, or the eye button, to show it. It hides again after 30 seconds.
  • Copy puts the value on your clipboard without showing it on screen.
  • Remove deletes the entry from the keychain.

On a computer these buttons appear when you point at a row. On a phone they are always there.

Locking

A keychain locked with your vault opens whenever your vault is unlocked, and locks again with it. While it is locked you see the keychain's name and size, and none of its values.

Some keychains have a passphrase of their own. Those show Unlock, which asks for that passphrase.

The Account Keychain

When you give Pax an API key for an AI provider, blackbear keeps it in your Account Keychain. To open it, go to Settings, then Pax, and follow the Account Keychain link. It syncs to your other devices end-to-end encrypted, and it can't be moved to Trash.

Other kinds of store

A key-value store is a plain table of keys and values, shown as they are. Use it for settings and other values that don't need hiding. Stores can also describe a connection, such as a Postgres database. Those show the connection's details, and any saved credential reads as hidden.

From the command line

The bb command line tool works with the same stores:

CommandWhat it does
bb store create "API Keys" --kind keychainMakes a keychain. --kind kv makes a key-value store
bb store keychain set <store> <key>Adds or replaces an entry. Leave out the value and pipe it in instead, which keeps it out of your shell history
bb store keychain get <store> <key>Prints the value
bb store keychain list <store>Lists the entries
bb store keychain rm <store> <key>Removes an entry

A store can be named by its ID or the first few characters of it.

Copies

A store has nothing to download, so its values never leave blackbear in a file. Copy a value when you need it somewhere else.