PoGoPass

Secure, offline, CLI-based password manager built in Go.

Get Started View on GitHub

terminal

Features

PoGoPass combines security, simplicity, and performance in a lightweight CLI tool.

AES-256 Encryption

Military-grade encryption to keep your passwords secure and protected.

Offline Storage

Your passwords never leave your device, ensuring maximum privacy and security.

Cross-Platform

Works seamlessly across Linux, macOS, and Windows operating systems.

Lightweight

Minimal resource usage with fast performance, even on older hardware.

CLI Interface

Simple command-line interface for power users and easy scripting.

Installation

Get up and running with PoGoPass in minutes.

1. Clone the repository

git clone https://github.com/arwindpianist/PoGoPass.git

2. Navigate to the directory

cd PoGoPass

3. Build the application

go build -o pogopass

4. Make it executable

chmod +x pogopass

5. Move to a directory in your PATH (optional)

sudo mv pogopass /usr/local/bin/

Commands

PoGoPass offers a simple and intuitive command-line interface.

Command	Description	Usage
add	Add a new password entry	add -name <service_name> -username <username> -password <password>
list	List all saved passwords	list
delete	Delete a password entry by ID	delete -id <entry_id>
show	Show the decrypted password entry by ID	show -id <entry_id>
reindex	Rebuild ID order of the database	reindex
help	Show the help message	help
quit	Exit the application	quit

Usage Example

See PoGoPass in action with this sample session.

terminal

✅ Credits: arwindpianist
💡 Get started by entering your master password.
🔑 Enter your master password: Abcd1234!
✅ Master key verified successfully
ℹ️ Enter command (add, list, delete, show, reindex, help, quit):
help
PoGoPass Help:
Usage:
  add     - Add a new password entry
           Usage: add -name <service_name> -username <username> -password <password>
           Example: add -name Tiktok -username arwin -password yourpassword
           If no password is provided, a random password will be generated.

  list    - List all saved passwords
           Usage: list

  delete  - Delete a password entry by ID
           Usage: delete -id <entry_id>
           Example: delete -id 1

  show    - Show the decrypted password entry by ID
           Usage: show -id <entry_id>
           Example: show -id 1

  reindex - Rebuild ID order of the database
           Usage: reindex

  help    - Show this help message
           Usage: help

  quit    - Exit the application
           Usage: quit
ℹ️ Enter command (add, list, delete, show, reindex, help, quit):

Configuration

Configure PoGoPass with these essential environment variables.

Environment Variables

Create a .env file in the same directory as the executable with these required settings:

# PoGoPass Configuration

# Security settings
PEPPER=PoGoPassPepper!
SALT=PoGoPassSalt1234
HASH_FILE=masterkey.hash

Configuration Explanation

•
PEPPER
A secret value added to passwords before hashing for additional security. Keep this value consistent and secure.
•
SALT
Another security element used in the encryption process. Like the pepper, this should remain consistent.
•
HASH_FILE
The filename where the master password hash will be stored. This file is used to verify your master password on login.

Security Note

For maximum security, you should change the default PEPPER and SALT values to your own unique values. Keep these values private and never share them. If you lose these values, you will not be able to decrypt your passwords.

Releases

Stay up to date with the latest versions and improvements.