pgg-cli

pgg — Password Generator in Golang

pgg is a secure, terminal-based password generator written in Go, built on top of crypto/rand.
It allows you to generate strong passwords, save them locally, copy them to the clipboard, and manage them directly from the command line.

This project is designed as a lightweight and secure alternative to GUI-based password managers, focused on developer workflows.

Features

• Cryptographically secure password generation using crypto/rand
• Configurable password length and character sets
• Save generated passwords with a service identifier
• Copy passwords to clipboard
• List, delete, and export saved passwords
• Built using Cobra for a clean CLI experience

Installation

Using Go

go install github.com/leonibeldev/pgg-cli@latest

Build from source

git clone https://github.com/leonibeldev/pgg-cli.git
cd pgg-cli
go build -o pgg-cli main.go

Usage

Generate a password with a custom length and character types:

pgg-cli --length 10 --types lower,numbers,special --save facebook.com

Example output:

Password 4sd56456sa3?w2

Flags

Password Generation

Character Types

Example:

pgg-cli --length 12 --types lower,numbers

Password Management

List Saved Passwords

pgg-cli --list

Output example:

-----------------------------------------------
|   ID   |     Service     |      Password    |
|---------------------------------------------|
|  5132  |  facebook.com  |  4sd56456sa3?w2   |
-----------------------------------------------

Delete a Password

pgg-cli --delete 5132

Confirmation:

Are you sure you want to delete password with ID 5132? [y/N]: 

Export Passwords

Export all stored passwords to a JSON file in the actual directory:

pgg-cli --export

Example output file:

[
  {
    "ID": 5132,
    "Service": "facebook.com",
    "Password": "fd538245d2z105104:'s",
    "Username": "user123",
    "Created_at": "10/10/10"
  }
]

Version

pgg-cli --version

Project Structure

• cmd/ – CLI commands and flags
• crypt/ – Secure password generation logic
• flags/ – Flag parsing and validation
• utils/ – Persistence and helper utilities

Security Notes

• Passwords are generated using crypto/rand, not math/rand
• No passwords are sent over the network
• Local storage responsibility belongs to the user

Roadmap

• Encrypted local storage
• Clipboard auto-clear timeout
• Config file support
• Cross-platform clipboard improvements

License

MIT License © 2026 LeonibelDev