passm - A Simple Command-Line Password Manager

passm is a lightweight command-line password manager written in Rust ( uwu :3 ). It allows users to store, list, add, and remove username-password pairs in a local JSON file.

Important: This tool is not secure and is intended for educational or experimental use only.
Do not use it to store real credentials or sensitive information.

Features

• Simple CLI interface
• Local JSON-based password storage (~/.passm)
• Supports the following subcommands:
  • init — Initialize the password database
  • add — Add a new username/password pair
  • remove — Remove an entry by index
  • list — List all stored credentials
  • clear — Delete all stored entries

Usage

passm [SUBCOMMAND] [ARGS]

Subcommands

Example

passm init
passm add github myuser mypassword123
passm list
passm remove 0

Security Notice

This program does not provide any real security for stored credentials. It is for learning or demonstration purposes only.

Current security issues:

• Passwords are stored in plain text in ~/.passm
• No encryption or hashing is implemented
• No authentication or master password protection

Do not use this application to store any real passwords or confidential information.

Security TODO

To improve security, the following enhancements are recommended:

• Encrypt stored passwords using a library such as ring or aes-gcm
• Implement a master password to unlock the database
• Use system keyrings (macOS Keychain, GNOME Keyring, Windows Credential Manager)
• Add password masking when entering credentials
• Hash the master password with a strong algorithm like bcrypt or argon2

License

This project is open source under the MIT License.
You are free to use, modify, and learn from it, but do not rely on it for real-world password management.