Metadata-Version: 2.4
Name: keypass-cli
Version: 0.1.0
Summary: keypass — minimal secure CLI demo (test only)
Author-email: khalil ben anane <benananekhalilo@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/yourusername/myapp
Project-URL: Repository, https://github.com/yourusername/myapp
Project-URL: Issues, https://github.com/yourusername/myapp/issues
Keywords: cli,security,encryption,mongodb,credentials
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: pymongo>=4.0.0
Requires-Dist: cryptography>=40.0.0
Requires-Dist: keyring>=24.0.0
Dynamic: license-file

# 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
```bash
pip install keypass-secure-cli
```

### Step 2: Initialize & Use (Zero Setup!)
```bash
keypass init
keypass add-cred github_token
keypass get-cred github_token
keypass delete-cred github_token
```

### 🔑 Master Key Management (Multi-PC Access)
```bash
# Export master key to use on other PCs
keypass export-master-key my-key.txt

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

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

# Restore everything on another PC
keypass 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:**
```bash
export MONGO_ATLAS_USER="your_username"
export MONGO_ATLAS_PASS="your_password"
export MONGO_ATLAS_CLUSTER="your_cluster_name"
```

**Use Local MongoDB:**
```bash
brew install mongodb-community  # macOS
brew services start mongodb-community
```

### 🎯 Quick Setup Script
```bash
# 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.
