passkey-cli 0.2.0

A secure CLI password manager connected to MongoDB

keypass — minimal secure CLI demo (test only)

This is a small demo CLI you can install locally and use to test encrypted storage with MongoDB.

NOT production-ready. Intended for quick testing.

🚀 Quick Start for Users

Step 1: Install

pip install passkey-secure-cli

Step 2: Initialize & Use (Zero Setup!)

passkey init
passkey add-cred github_token
passkey get-cred github_token
passkey delete-cred github_token

🔑 Master Key Management (Multi-PC Access)

# Export master key to use on other PCs
passkey export-master-key my-key.txt

# Import master key on another PC
passkey import-master-key my-key.txt

# Complete backup (credentials + master key)
passkey backup-cred my-backup.json

# Restore everything on another PC
passkey restore-cred my-backup.json

That's it! The app automatically connects to our secure cloud database.

🔧 Advanced Setup (Optional)

Use Your Own Atlas Database:

export MONGO_ATLAS_USER="your_username"
export MONGO_ATLAS_PASS="your_password"
export MONGO_ATLAS_CLUSTER="your_cluster_name"

Use Local MongoDB:

brew install mongodb-community  # macOS
brew services start mongodb-community

🎯 Quick Setup Script

# Run the interactive setup script
./quick_setup.sh

Warnings & next steps

This demo stores secrets in MongoDB encrypted with a symmetric key stored in your OS keyring. For production:

• Use KMS (AWS KMS / GCP KMS / HashiCorp Vault) or a secure HSM.
• Add authentication and audit logging.
• Rotate keys, protect logs, and never print secrets in plain text.