CliPassMan

Console Smart Password Manager

Terminal-based smart password manager with deterministic password generation. Generate, manage, and retrieve passwords without storing them - all from your command line.


clipassman - Console Smart Password Manager. Terminal-based smart password manager with deterministic password generation. Generate, manage, and retrieve passwords without storing them - all from your command line.

Decentralized by Design: Unlike traditional password managers that store encrypted vaults on central servers, Smart Password Manager stores nothing. Your secrets never leave your device. Passwords are regenerated on-demand - no cloud, no database, no trust required.

  • Zero-Storage Security - no passwords or secret phrases are ever stored or transmitted
  • Decentralized Architecture - no central servers, no cloud dependency
  • Deterministic Regeneration - passwords are recreated identically from your secret phrase
  • Metadata Only - store only descriptions and verification keys
  • Terminal Processing - all cryptographic operations happen in your CLI
  • On-Demand Discovery - passwords exist only when you generate them

  • Decentralized & Serverless - no central database, no cloud lock-in
  • No Password Database - eliminates password storage completely
  • Interactive Terminal UI - clean, centered text with visual framing
  • Public Key Verification - verify secret knowledge without exposure
  • List View - see all your password metadata in clear lists
  • Export/Import - backup and restore functionality with timestamped files
  • Bulk Operations - clear all passwords with double confirmation
  • Secure Hidden Input - hidden secret phrase entry via getpass
  • No Dependencies - only Python standard library + smartpasslib
  • Server Ready - perfect for headless systems and remote management

  • Proof of Knowledge - public keys verify secrets without exposing them
  • Decentralized Trust - no third party needed
  • Deterministic Security - same secret + length = same password, always
  • Metadata Separation - non-sensitive data stored separately from verification
  • Local Processing - no data leaves your computer
  • No Recovery Backdoors - lost secret = permanently lost access

Powered by smartpasslib v4.0.0+ - The core library for deterministic password generation.

Key derivation (same as Python/JS/Kotlin/Go/C#/Rust versions v4.0.0):

Key TypeIterationsPurpose
Private Key15-30 (dynamic)Password generation (never stored, never transmitted)
Public Key45-60 (dynamic)Verification (stored locally)

Character Set:

!@#$%^&*()_+-=[]{};:,.<>?/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyz

Validation Rules: Secret phrase: min 12 chars · Password length: 12-100 chars

What's NOT stored: Secret phrase · The actual password · Any reversible password data

What IS stored (in ~/.config/smart_password_manager/passwords.json):

  • Public verification key (hash of secret)
  • Service description
  • Password length parameter

Prerequisites: Python 3.7+, pip

# Install from PyPI
pip install clipassman==4.0.0

# Verify installation
clipassman

Quick Run from Repository:

git clone https://github.com/smartlegionlab/clipassman.git
cd clipassman
python app.py

Launching the Application:

clipassman

Main Menu Options:

  • 1 - Add Password
  • 2 - Get/Delete Password
  • 3 - Export/Import Passwords
  • 4 - Clear All Passwords
  • 5 - Help
  • 0 - Exit

Creating Your First Password:

  1. Launch clipassman
  2. Select option 1: Add Password
  3. Enter service description
  4. Enter your secret phrase (min 12 characters)
  5. Confirm your secret phrase
  6. Set password length (12-100, 16-24 recommended)
  7. Password is generated and displayed

Retrieving a Password:

  1. Select option 2: Get/Delete Password
  2. Choose password entry from numbered list
  3. Select 1: Get password
  4. Enter your secret phrase (hidden input)
  5. Password regenerates identically

  • Pointer-Based Security Paradigm - 10.5281/zenodo.17204738
    Architectural Shift from Data Protection to Data Non-Existence
  • Local Data Regeneration Paradigm - 10.5281/zenodo.17264327
    Ontological Shift from Data Transmission to Synchronous State Discovery

Secret Phrase Security

  • Permanent data loss - lost secret phrase = irreversible loss of all derived passwords
  • No recovery mechanisms - no password recovery, no secret reset
  • Deterministic generation - identical input = identical output
  • Single point of failure - secret phrase is the sole authentication factor

Secret Phrase Strength:

  • Minimum 12 characters is enforced
  • Short secrets (under 12 chars) are automatically rejected
  • Use a mix of: uppercase, lowercase, numbers, symbols

Remember: The app cannot recover your secret phrase. If you lose it, all passwords are permanently lost.

  • Linux: ~/.config/smart_password_manager/passwords.json

By using this software, you agree to the full disclaimer terms.

Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: See DISCLAIMER.md

License: BSD 3-Clause License