Contributing to PassTUI

March 25, 2026 · View on GitHub

PassTUI is open to contributions!

Development

First, you will need to install uv to manage the development dependencies.

Then, setup an environment for development, run:

uv sync

Once the sync process is finished, you should have a virtual environment with the dependencies installed.

Activate the virtual environment:

source .venv/bin/activate

To start in development mode, run:

textual console

Then in another terminal, run:

TEXTUAL=devtools,debug passtui

To use a custom store path—mainly for testing—run:

PASSWORD_STORE_DIR="~/.testing-password-store" TEXTUAL=devtools,debug passtui

Running the tests

Run the tests with:

pytest