# 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 passkey-secure-cli
```
### Step 2: Initialize & Use (Zero Setup!)
```bash
passkey init
passkey add-cred github_token
passkey get-cred github_token
passkey delete-cred github_token
```
### 🔑 Master Key Management (Multi-PC Access)
```bash
# 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:**
```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.
Raw data
{
"_id": null,
"home_page": null,
"name": "passkey-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "cli, security, encryption, mongodb, passwords",
"author": null,
"author_email": "Med Ali Lahmer <dalilahmer1212@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/7e/26/b47fd2f47f5d56ee848871d32b7f16de6d1e3f3356287b9fe3dfc38f18fd/passkey_cli-0.2.0.tar.gz",
"platform": null,
"description": "# keypass \u2014 minimal secure CLI demo (test only)\r\n\r\nThis is a small demo CLI you can install locally and use to test encrypted storage with MongoDB.\r\n\r\n**NOT production-ready.** Intended for quick testing.\r\n\r\n## \ud83d\ude80 Quick Start for Users\r\n\r\n### Step 1: Install\r\n```bash\r\npip install passkey-secure-cli\r\n```\r\n\r\n### Step 2: Initialize & Use (Zero Setup!)\r\n```bash\r\npasskey init\r\npasskey add-cred github_token\r\npasskey get-cred github_token\r\npasskey delete-cred github_token\r\n```\r\n\r\n### \ud83d\udd11 Master Key Management (Multi-PC Access)\r\n```bash\r\n# Export master key to use on other PCs\r\npasskey export-master-key my-key.txt\r\n\r\n# Import master key on another PC\r\npasskey import-master-key my-key.txt\r\n\r\n# Complete backup (credentials + master key)\r\npasskey backup-cred my-backup.json\r\n\r\n# Restore everything on another PC\r\npasskey restore-cred my-backup.json\r\n```\r\n\r\n**That's it!** The app automatically connects to our secure cloud database.\r\n\r\n### \ud83d\udd27 Advanced Setup (Optional)\r\n\r\n**Use Your Own Atlas Database:**\r\n```bash\r\nexport MONGO_ATLAS_USER=\"your_username\"\r\nexport MONGO_ATLAS_PASS=\"your_password\"\r\nexport MONGO_ATLAS_CLUSTER=\"your_cluster_name\"\r\n```\r\n\r\n**Use Local MongoDB:**\r\n```bash\r\nbrew install mongodb-community # macOS\r\nbrew services start mongodb-community\r\n```\r\n\r\n### \ud83c\udfaf Quick Setup Script\r\n```bash\r\n# Run the interactive setup script\r\n./quick_setup.sh\r\n```\r\n\r\n## Warnings & next steps\r\n\r\nThis demo stores secrets in MongoDB encrypted with a symmetric key stored in your OS keyring. For production:\r\n\r\n- Use KMS (AWS KMS / GCP KMS / HashiCorp Vault) or a secure HSM.\r\n- Add authentication and audit logging.\r\n- Rotate keys, protect logs, and never print secrets in plain text.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A secure CLI password manager connected to MongoDB",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/MedAliLahmer/passkey-cli",
"Issues": "https://github.com/MedAliLahmer/passkey-cli/issues",
"Repository": "https://github.com/MedAliLahmer/passkey-cli"
},
"split_keywords": [
"cli",
" security",
" encryption",
" mongodb",
" passwords"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "afcb3a0212833617e5e0d8ca75f9830e4df13367b071425a98c7041bcae84149",
"md5": "816427e1867609ffdfce404895b948b4",
"sha256": "bff967df21c859b8afd4d7116645913ebea71b31d6485f10d9d91e2149271eba"
},
"downloads": -1,
"filename": "passkey_cli-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "816427e1867609ffdfce404895b948b4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 9742,
"upload_time": "2025-10-25T01:38:23",
"upload_time_iso_8601": "2025-10-25T01:38:23.646365Z",
"url": "https://files.pythonhosted.org/packages/af/cb/3a0212833617e5e0d8ca75f9830e4df13367b071425a98c7041bcae84149/passkey_cli-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7e26b47fd2f47f5d56ee848871d32b7f16de6d1e3f3356287b9fe3dfc38f18fd",
"md5": "746e23416cf14da0c1d73a805b468c26",
"sha256": "772b82e9399af4e7570f0609e3925bf9486d0394be4ccc2e9a9b6896f0f30245"
},
"downloads": -1,
"filename": "passkey_cli-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "746e23416cf14da0c1d73a805b468c26",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 10364,
"upload_time": "2025-10-25T01:38:25",
"upload_time_iso_8601": "2025-10-25T01:38:25.011856Z",
"url": "https://files.pythonhosted.org/packages/7e/26/b47fd2f47f5d56ee848871d32b7f16de6d1e3f3356287b9fe3dfc38f18fd/passkey_cli-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-25 01:38:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MedAliLahmer",
"github_project": "passkey-cli",
"github_not_found": true,
"lcname": "passkey-cli"
}
JSON
