lbx - Lock Box

A lightweight secret storage vault with CLI and Python API. Stores secrets in encrypted files with master password secured via OS keychain.

Features

• Secure Encryption: AES-256 encryption with master password protection
• Cross-Platform: Works on Windows, macOS, and Linux
• Dual Interface: Both CLI and Python API available
• Keychain Integration: Master password stored securely in OS keychain
• Simple Workflow: Intuitive commands for daily use
• Minimal Dependencies: Lightweight and secure

Installation

pipx install lbx

For additional installation methods, see the Installation Guide.

Quick Start

CLI Usage

# Create a new vault
lbx vault init

# Add a secret
lbx secret add github token --value ghp_xxxxxx

# Retrieve a secret
lbx secret get github token

# 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 or delete the vault
lbx vault lock
lbx vault delete

Python API

from lbx import Lbx

vault = Lbx()

vault.add_secret("github", "token", "value")
entry = vault.get_secret("github", "token")
print(entry.value)

vault.list_services()
vault.list_secrets()

For complete examples and tutorials, see the Quick Start Guide.

Use Cases

• Development Teams: Store API keys, database credentials, and service tokens securely
• DevOps & CI/CD: Manage secrets in deployment pipelines and infrastructure automation
• Personal Projects: Keep sensitive configuration data encrypted and organized
• Security-Conscious Users: Replace plain-text config files with encrypted secret storage

Documentation

Complete documentation is available at: https://jd-35656.github.io/lbx/latest/

• Installation Guide - Detailed installation instructions
• Quick Start - Get started in minutes
• CLI Reference - Complete command documentation
• API Reference - Python API documentation
• Contributing - How to contribute

Requirements

• Python 3.10 or higher
• Windows, macOS, or Linux
• OS keychain support (automatic)

Contributing

Contributions are welcome! Please read the Contributing Guide for details on our development process, coding standards, and how to submit pull requests.

License

MIT License - see LICENSE file for details.

Support

• Documentation: https://jd-35656.github.io/lbx/latest/
• PyPI Package: pypi.org/project/lbx
• Bug Reports: GitHub Issues
• Discussions: GitHub Discussions

© 2025 Jitesh Sahani (JD)
📧 jitesh.sahani@outlook.com

"Your secrets are safe, your mind at peace."
🐺 Crafted by a dreamer, for dreamers 🐺