# psn [](https://github.com/l5yth/psn/actions/workflows/rust.yml) [](https://codecov.io/gh/l5yth/psn) [](https://github.com/l5yth/psn/releases) [](https://crates.io/crates/psn) [](https://aur.archlinux.org/packages/psn-bin) [](https://github.com/l5yth/psn/blob/main/flake.nix) [](https://github.com/l5yth/psn/tree/main/packaging/gentoo) [](https://github.com/l5yth/psn) [](https://github.com/l5yth/psn/blob/main/LICENSE) `psn` is a Rust terminal UI for viewing process status and sending signals.  - [x] Browse running processes in a terminal UI - [x] Filter processes by text match `` or regular expression `-r ` - [x] Filter interactively while browsing with `/` - [x] Show only the current user's processes with `-u` - [x] Send Unix signals `1` through `9` to the selected process Read more: [Dev.to: psn - a minimalist process navigator for Linux](https://dev.to/l5y/psn-a-minimalist-process-navigator-for-linux-37jn) ## Dependencies - GNU/Linux (process data is read from `/proc` via [sysinfo](https://crates.io/crates/sysinfo) — no external binaries required) - Rust stable toolchain (Rust 2024 edition, Cargo) for building from source Core crates: `ratatui`, `crossterm`, `sysinfo`, `nix`, `anyhow`, `users`. ## Installation Helpers exist for Arch and Gentoo-based systems but you can install also via crates.io or from source directly. ### Archlinux See [PKGBUILD](./packaging/archlinux/PKGBUILD) ### Gentoo See [psn-9999.ebuild](./packaging/gentoo/app-misc/psn/psn-9999.ebuild) ### Cargo Crates ```bash cargo install psn ``` ### From Source Build from source: ```bash git clone https://github.com/l5yth/psn.git cd psn cargo build --release ``` Run the built binary: ```bash ./target/release/psn ``` Or run directly in development: ```bash cargo run --release -- ``` ## Usage ```text psn v0.1.4 process status navigator apache v2 (c) 2026 l5yth usage: psn usage: psn [OPTIONS] -f usage: psn [OPTIONS] -r Terminal UI for browsing process status and sending Unix signals. Options: -h, --help Show usage instructions -v, --version Show version -f, --filter Filter process names/commands (case insensitive string) -r, --regex Use regex matching (regular expression pattern) -u, --user Show only current user's processes ``` Examples: ```bash # substring filter (positional) psn "sshd" # substring filter via option psn -f "systemd" psn --filter "python" # regex filter psn -r 'ssh(d|agent)' psn --regex '(nginx|apache2)' # current user only psn -u psn -u -f "cargo" psn -u -r '^bash$' ``` In-app keys: - `q`: quit - `r`: refresh process list - `↑` / `↓`: move selection - `PgUp` / `PgDn`: page up/down - `←` / `→`: collapse / expand tree node - `/`: open interactive filter prompt (live, substring match); `Enter` confirms, `Esc` cancels - `1`..`9`: send corresponding signal to selected process (prompts for confirmation); not available while the filter prompt is open — press `Enter` or `Esc` first ## Development ```bash cargo check cargo test --all --all-features --verbose cargo fmt --all cargo clippy --all-targets --all-features -- -D warnings ```