Metadata-Version: 2.4
Name: pitt
Version: 0.8.2
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: Repository, https://github.com/quandelaa/pitt
Description-Content-Type: text/markdown

# pitt

an extremely simple terminal-based password manager

## installation

```bash
pip install pitt
```

# demo
[![pitt demo](https://img.youtube.com/vi/g3S1TFWb2uU/maxresdefault.jpg)](https://www.youtube.com/watch?v=g3S1TFWb2uU)
(click)

## usage

### commands

1. `pitt init`:
    * asks for a master password
    * when given, hashes 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 the specified username, 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 note) of all the saved passwords

    example:
    ```bash
    pitt list
    ```

4. `pitt del`:
    * gets the password that is saved with the given service or username
    * asks for confirmation
    * deletes the found password 

    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 alongside some rubber ducks
