Skip to content

Quick Start

Get up and running with lbx in minutes.

Installation

pipx install lbx

See Installation Guide for other installation options.

CLI Usage

Create a new vault

lbx vault init

You'll be prompted for a password. The derived encryption key is stored in your OS keychain.

Add a secret

lbx secret add github token --value ghp_xxxxxx

Or pipe it for better security:

printf "ghp_xxxxxx" | lbx secret add github token

Retrieve a secret

lbx secret get github token

If the keychain key is missing or outdated, you'll be prompted for the password.

Update a secret

printf "new-value" | lbx secret update github token

List services and secrets

lbx service list
lbx secret list
lbx secret list --service github

Rename or move secrets

lbx secret rename github token api_key
lbx secret move github api_key gitlab

Lock the vault

lbx vault lock

Delete the vault

lbx vault delete

Python API

from lbx import Lbx

# Load vault (auto-load key from keychain when available)
vault = Lbx()

vault.get_secret("github", "token")  # returns SecretEntry
vault.add_secret("github", "token", "new-value")
vault.list_services()
vault.list_secrets()

Next Steps

See Also

Documentation:

Support: