🔐 bwenv

Bitwarden + direnv Helper - Effortlessly sync secrets from Bitwarden folders into your shell environment with direnv magic!

Quick Start Installation Guide View on GitHub

✨ Key Features

Interactive folder selection

Pick Bitwarden folders interactively or by name with an easy-to-use CLI interface.

Automatic .envrc generation

Instantly create a ready-to-use .envrc file for direnv without manual configuration.

Secure session management

Handles Bitwarden session unlocking for you with secure authentication.

Debug mode

See exactly which secrets are loaded with detailed debugging options.

Easy install/uninstall

One command setup & cleanup with cross-platform support.

Cross-platform

Works seamlessly on Linux, macOS, and Windows environments.

🚀 Quick Overview

bwenv is a CLI tool that bridges your Bitwarden vault and your shell environment using direnv. It lets you securely load secrets from any Bitwarden folder directly into your .envrc, making secret management for development and deployment a breeze.

Example Workflow

# Install and setup
make install
make setup-path              # Add ~/.local/bin to PATH (Linux/macOS)

# Test installation
bwenv test

# Initialize secrets
bwenv init                   # Manual folder entry
# or
bwenv interactive           # Pick from list

# Allow direnv to load secrets
direnv allow

# Your secrets are now available as environment variables!
echo $YOUR_SECRET_VAR