PassMgr - Secure Local Password Manager

PassMgr is a simple yet secure command-line password management tool focused on core functionality and secure encryption, running entirely locally without relying on any external services.

Features

• Secure Password Storage: All passwords are stored locally using AES-256 encryption
• Password Entry Management: Easily add, view, update, and delete password entries
• Password Generation: Generate high-strength random passwords
• Simple to Use: Intuitive command-line interface with no complex setup
• Interactive Shell Mode: Work with multiple commands while only entering your master password once

Installation

# Clone the repository
git clone https://github.com/yourusername/pwmgr.git
cd pwmgr

# Install dependencies
pip install -r requirements.txt

Usage

Standard CLI Mode

Initialize (first run):

python -m pwmgr init

Add a new password:

python -m pwmgr add --name "GitHub" --username "user@example.com"

List passwords:

python -m pwmgr list

View specific password details:

python -m pwmgr show --name "GitHub"

Generate a random password:

python -m pwmgr generate --length 20 --include-symbols

Interactive Shell Mode

For convenience when working with multiple passwords, you can use the interactive shell mode, which only requires entering your master password once:

python -m pwmgr shell

Inside the shell, you can run commands like:

pwmgr> list
pwmgr> show --name "GitHub" --show-password
pwmgr> add --name "Twitter" --username "user@example.com" --auto-generate-password
pwmgr> generate --length 24
pwmgr> help

Type exit or quit to leave the shell.

Security Notes

• All passwords are stored using AES-256 encryption
• Master password is never saved, only used to derive encryption keys
• All sensitive data is only decrypted in memory and cleared immediately after use
• Data file is stored in ~/.pwmgr/passwords.json.enc by default