Metadata-Version: 2.4
Name: pitt
Version: 0.5.0
Summary: an extremely simple terminal-based password manager
Keywords: password-manager,terminal,cli,security,encryption
Author: quandelaa
Author-email: quandelaa <sergiotobamasilalahi@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Security :: Cryptography
Requires-Dist: argon2-cffi>=25.1.0
Requires-Dist: cryptography>=49.0.0
Requires-Dist: platformdirs>=4.10.1
Requires-Dist: pyperclip>=1.11.0
Requires-Dist: rich>=15.0.0
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/quandelaa/pitt
Project-URL: Repository, https://github.com/quandelaa/pitt
Description-Content-Type: text/markdown

# pitt

an extremely simple terminal-based password manager.

## installation

```bash
pip install pitt
```

## usage

### commands

1. `pitt init`:
    * asks for a master password
    * when given, encrypts it using Argon2id and stores it in the database

    example:
    ```bash
    pitt init
    ```

2. `pitt add`:
    * create random password
    * encrypts the random password using Fernet
    * stores the encrypted password with a specified username or service or note in the database

    example:
    ```bash
    pitt add --service github --username quandelaa --note "this is my song"
    ```

3. `pitt get`:
    * gets the password that is saved with the given service or username
    * decrypts the password
    * copies it to user's clipboard

    example:
    ```bash
    pitt get --service github --username quandelaa
    ```

4. `pitt list`:
    * lists only the details (service, username and notes) of all the saved passwords

    example:
    ```bash
    pitt list"
    ```

4. `pitt del`:
    * deletes a password in the password vault that is saved with the given service or username 

    example:
    ```bash
    pitt del --service github --username quandelaa
    ```

## license

this project is licensed under the MIT License - see the LICENSE file for details

## credits

inspired by: themohitnair's sfnx | (https://github.com/themohitnair/sfnx)

---

curated by me with passion and a teensy bit of stress
