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:
| Field | What it's for |
|---|---|
| Key | The entry's name, like github-token. Required |
| Label | A friendlier name to show in the list. Optional |
| Value | The secret itself. Required |
| Kind | Secret, Password, API Token, Key Pair, Certificate, Config or Text |
| Service | What 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:
| Command | What it does |
|---|---|
bb store create "API Keys" --kind keychain | Makes 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.