passmanage 1.0.0

A simple CLI password manager with AES encryption

🔐 Passman — Simple CLI Password Manager

Passman is a lightweight, command-line based password manager built in Python. It securely stores your passwords in an encrypted SQLite database — only accessible with your master password.

🚀 Features:

🔒 Secure AES-based encryption using a master password

🧠 Master password verified before any access

🗄️ Passwords stored locally in an encrypted SQLite database

📜 List, add, delete, or retrieve services easily

🎨 Colored output for better readability

⚙️ Cross-platform (Linux, macOS, Windows)

📦 Installation: 🧩 Option 1: Local Installation (Developer Mode)

Clone the repository and install it locally in editable mode:

git clone https://github.com/<your-username>/passman.git
cd passman
pip install -e .

💡 The -e flag means “editable mode”, so any changes to the code will reflect instantly.

Now, you can use the command:
pass

🔑 First-Time Setup:

When you run any command (like add, list, get, etc.) for the first time,
passman will automatically ask you to create a master password:

  ```bash
  No Master Password Set. Let's Create One Now.
  Create Master Password: ********
  Confirm Master Password: ********
  Master password saved. Keep it safe!

This password will be used to encrypt and decrypt all your stored credentials.
You’ll need to enter it every time you open a new terminal session.

⚙️ Usage:

📥 Add a new service
  Add a password for a service (e.g., Gmail, GitHub, Discord):

```bash
  pass add <service_name> -u <username> <password>

🔍 Get a service password

Retrieve a stored password for a service:
  pass get <service_name>

📋 List all saved services
1️⃣  Without showing passwords:
  pass list

2️⃣ Show list with decrypted passwords: 
  pass list --show

❌ Delete a service
  Remove a saved password entry by service name:

  pass del <service_name>

💻 Development Commands 

 - Install locally (editable):
    pip install -e .
 - Uninstall:
    pip uninstall passman -y


🧠 Future Enhancements

🔐 Multi-user support

☁️ Optional cloud sync

🧩 Auto password generation

🧰 Backup and restore feature