cryptknox 0.2.3

A light weight secure CLI tool for storing, retrieving, deleting, and generating encrypted passwords.

CryptKnox 🔐

CryptKnox is a lightweight CLI-based encrypted password manager written in Python. It allows you to securely store, retrieve, delete, and generate passwords using a single master password.

All stored credentials are encrypted locally using AES encryption, ensuring your secrets remain protected.

---

Features

• 🔐 AES Encryption for secure password storage
• 🗂 Store multiple accounts per service
• 🔍 Retrieve specific accounts, services, or all credentials
• ❌ Delete individual entries, services, or entire vault
• 🔑 Generate strong random passwords
• 💻 Simple CLI interface
• 📦 Installable via PyPI

---

Installation

Install from PyPI:

pip install cryptknox

After installation you can run:

cryptknox --help

---

Usage

cryptknox --operation|-o [store|retrieve|delete|generate] [OPTIONS]

---

Operations

Store Credentials

Store a password for a service.

cryptknox -o store -m MySecretPassword -s gmail -u [e-mail] -p mypassword

Options:

Option	Description
--operation, -o	Operation (store)
--master-password, -m	Master password used for encryption
--service, -s	Service name (example: gmail)
--username, -u	Username for the service
--password, -p	Password to store

---

Retrieve Credentials

Retrieve stored passwords based on scope.

Retrieve a specific account:

cryptknox -o retrieve -m MySecretPassword -s gmail -u [e-mail]

Retrieve all accounts under a service:

cryptknox -o retrieve -m MySecretPassword -s gmail

Retrieve all services:

cryptknox -o retrieve -m MySecretPassword -s all

Behavior:

• -s all → retrieves entire vault
• -s <service> → retrieves all usernames under that service
• -s <service> -u <username> → retrieves only that account

---

Delete Credentials

Delete stored credentials based on scope.

Delete a specific account:

cryptknox -o delete -m MySecretPassword -s gmail -u [e-mail]

Delete all accounts under a service:

cryptknox -o delete -m MySecretPassword -s gmail

Delete entire vault:

cryptknox -o delete -m MySecretPassword -s all

Behavior:

• -s all → deletes entire vault (confirmation required)
• -s <service> → deletes all usernames under that service
• -s <service> -u <username> → deletes only that account

---

Generate Secure Password

Generate a random secure password.

cryptknox -o generate -l 12

Options:

Option	Description
--length, -l	Length of generated password (must be greater than 4)

The generated password includes:

• uppercase letters
• lowercase letters
• numbers
• special characters

---

Examples

Store credentials:

cryptknox -o store -m MySecretPassword -s github -u myuser -p mypassword

Retrieve specific account:

cryptknox -o retrieve -m MySecretPassword -s github -u myuser

Retrieve all credentials:

cryptknox -o retrieve -m MySecretPassword -s all

Generate a strong password:

cryptknox -o generate -l 16

Delete specific account:

cryptknox -o delete -m MySecretPassword -s github -u myuser

Delete service:

cryptknox -o delete -m MySecretPassword -s github

Delete entire vault:

cryptknox -o delete -m MySecretPassword -s all

---

Security Notes

• All credentials are encrypted before being stored
• Only the master password can decrypt the vault
• The master password is never stored

⚠️ If the master password is lost, the vault cannot be recovered.

---

Requirements

• Python 3.9+

---

License

MIT License

---

Author

Developed by Sreejith

GitHub: https://github.com/Sreejith-R-Mohan/cryptknox