vaultuner

Human-readable secrets for Bitwarden Secrets Manager.

Vaultuner replaces cryptic UUIDs with intuitive paths like myapp/prod/db-password. Your secrets, organized the way you actually think about them.

The Problem

# Bitwarden's default CLI
bws secret get 550e8400-e29b-41d4-a716-446655440000

You shouldn't need to memorize UUIDs or dig through dashboards to find secrets.

The Solution

# With vaultuner
vaultuner get myapp/prod/db-password

Secrets organized by project and environment. Instantly memorable. Zero cognitive overhead.

Features

• Path-based naming - project/env/secret instead of UUIDs
• Environment isolation - Keep dev, staging, and prod secrets separate
• .env sync - Export to and import from .env files seamlessly
• Secret metadata - Attach descriptions to secrets via --description
• Soft delete - Recover accidentally deleted secrets
• Keychain storage - Credentials secured in macOS Keychain

Quick Start

Install

uv tool install vaultuner

Or run without installing:

uvx vaultuner list

Configure

vaultuner config set access-token <your-token>
vaultuner config set organization-id <your-org-id>

Get credentials from Bitwarden Secrets Manager.

Use

# Create secrets
vaultuner set myapp/api-key "sk-abc123"
vaultuner set myapp/prod/db-password "hunter2"

# Retrieve
vaultuner get myapp/prod/db-password -v

# List everything
vaultuner list

# Export for local dev
vaultuner export -p myapp -e dev -o .env

Commands

Naming Convention

PROJECT/SECRET           # Project-level secret
PROJECT/ENV/SECRET       # Environment-specific secret

Examples:

myapp/api-key            # Shared across environments
myapp/prod/db-password   # Production only
myapp/dev/db-password    # Development only

Requirements

• Python 3.11+
• macOS (Keychain integration)
• Bitwarden Secrets Manager account

Documentation

Full docs at vaultuner.alltuner.com

Support the project

vaultuner is an open source project built by David Poblador i Garcia through All Tuner Labs.

If this project was useful to you, consider supporting its development.

❤️ Sponsor development https://github.com/sponsors/alltuner

☕ One-time support https://buymeacoffee.com/alltuner

Your support helps fund the continued development of vaultuner and other open source developer tools such as Factory Floor.

License

MIT

Built at All Tuner Labs by David Poblador i Garcia