secure-mypass 0.2.2

Secure local terminal password manager

Secure MyPass

A lightweight and secure local password manager for Linux/macOS terminals.

Secure MyPass allows you to store and search credentials directly from your terminal using a simple text-based database located in your home directory.

No cloud storage. No external servers. No account required.

Features

• Store credentials locally in ~/.mypass
• Fast keyword search from the terminal
• Organize credentials into sections
• Simple and lightweight
• No internet dependency
• No vendor lock-in
• Easy backup and migration
• Linux and macOS friendly

Installation

Installation

Recommended (Linux/macOS/Windows)

Install using pipx:

pipx install secure-mypass

Ubuntu/Debian

If pipx is not installed:

sudo apt update
sudo apt install pipx

pipx ensurepath

Restart your terminal and install:

pipx install secure-mypass

Using Virtual Environment

python3 -m venv venv

source venv/bin/activate

pip install secure-mypass

Verify Installation

mypass init

Output:

Created: ~/.mypass

List entries:

mypass list

Create Password Store

Create a file named:

~/.mypass

Example:

[SSO Login]
Name: Portal SSO
Url: https://abc.com
UserName: ravi
Password: mypassword

Name: Terminal SSO
Command: aws configure sso

[Microsoft Email Services]
Name: xyz Mail
Email: [e-mail]
Password: mysecretpassword

Name: xyz Mail
Email: [e-mail]
Password: anotherpassword

Usage

Search by section name:

mypass xyz

Output:

[Microsoft Email Services]

Name: xyz Mail
Email: [e-mail]
Password: ********

Search by email:

mypass [e-mail]

Search by service name:

mypass xyz

File Location

Secure MyPass always reads credentials from:

~/.mypass

This ensures credentials remain under your control and can easily be backed up using Git, Dropbox, OneDrive, rsync, or any preferred method.

Security Notes

• All data is stored locally on your machine.
• No credentials are transmitted over the internet.
• No external services are used.
• Restrict file access:

chmod 600 ~/.mypass

Recommended permissions:

-rw------- ~/.mypass

Example Alias

Add to your .bashrc or .zshrc:

alias mypass="python3 ~/mypass_cli.py"

Or install from PyPI and use directly:

mypass xyz

Use Cases

• AWS SSO accounts
• Email credentials
• Internal portals
• Database logins
• Development environments
• Personal projects
• Infrastructure credentials

Why Secure MyPass?

Many password managers require cloud synchronization, subscriptions, or browser integrations.

Secure MyPass follows a different philosophy:

• Local-first
• Terminal-first
• Simple
• Fast
• Developer-friendly

Perfect for engineers, DevOps professionals, system administrators, and developers who prefer local credential management.

License

MIT License

Author

Ravi K

Lead Software Engineer

Python | Django | FastAPI | AWS | PostgreSQL

Commands

Command	Description
mypass init	Create password store
mypass add	Add new credential
mypass list	List all entries
mypass search <keyword>	Search credentials
mypass delete <keyword>	Delete credential

Quick Start

Create password store:

mypass init

Add a credential:

mypass add

Search credentials:

mypass search xyz

Delete a credential:

mypass delete xyz

Cross Platform

Secure MyPass works on:

• Ubuntu
• Debian
• Fedora
• CentOS
• macOS
• Windows CMD
• Windows PowerShell

No aliases required.

Storage

Credentials are stored locally in:

Linux/macOS

~/.mypass

Windows

C:\Users\<username>\.mypass

No cloud synchronization.

No external servers.

No account required.