pasx

A full-screen terminal password generator. Random characters or passphrases, live entropy, clipboard copy. It generates passwords; it never stores them.

Copying delegates to the platform's own clipboard tool — wl-copy, xclip, xsel or pbcopy, whichever is on PATH. A short-lived process cannot hold a Wayland or X11 selection open on its own; those tools daemonize, so the password is still there after pasx exits. The Nix package puts wl-copy on PATH for you.

Run

nix develop --command cargo run

The TUI needs at least a 40x14 terminal; below that it shows a "terminal too small" message instead of a broken layout.

Install

nix build
./result/bin/pasx

Or add it to a profile: nix profile install .

Keys

Key	Action
Up / Down	select a setting
Left / Right	change the selected setting
Space, Enter	toggle the selected setting
`r`	regenerate
`c`	copy to clipboard
Tab	switch between character and passphrase mode
`q`, Esc, Ctrl-C	quit

Command line

pasx --length 24 --no-symbols     # open the TUI pre-configured
pasx gen -l 18                    # print one password and exit
pasx gen -l 18 --copy             # ...and copy it
pasx completions nu               # print a shell completion script

Flags: --mode <charset|passphrase>, --length, --no-upper, --no-lower, --no-digits, --no-symbols, --exclude-ambiguous, --words, --separator, --capitalize, --add-number.

Shell completions

pasx completions <shell> prints a completion script for nu, bash, zsh, or fish to stdout; each is generated from the clap definition, so a new flag stays covered with no separate edit.

The Nix package ships the Nushell script at share/pasx/pasx.nu. Source it from your config:

source ~/.nix-profile/share/pasx/pasx.nu

Without Nix, save the script wherever your shell loads completions from, e.g.:

pasx completions bash > ~/.local/share/bash-completion/completions/pasx
pasx completions zsh > ~/.zfunc/_pasx
pasx completions fish > ~/.config/fish/completions/pasx.fish
pasx completions nu | save -f ~/.config/nushell/pasx.nu

Development

nix develop
cargo test
cargo clippy --all-targets -- -D warnings

License

Dual-licensed under either of LICENSE-MIT or LICENSE-APACHE, at your option.

The EFF wordlist bundled in src/generator/wordlist.txt is CC BY 3.0 US; see LICENSES/eff-wordlist.md.

2.4 KiB Raw Blame History