Skip to content

l5yth/psn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

psn

Rust Codecov GitHub Release Crates.io Top Language License: Apache-2.0

psn is a Rust terminal UI for viewing process status and sending signals.

Dependencies

  • any GNU/Linux system with ps obviously
  • ps available in $PATH
  • Some current Rust stable toolchain (Rust 2024 edition, Cargo)

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

Gentoo

See psn-9999.ebuild

Cargo Crates

cargo install psn

From Source

Build from source:

git clone https://github.com/l5yth/psn.git
cd psn
cargo build --release

Run the built binary:

./target/release/psn

Or run directly in development:

cargo run --release --

Usage

psn v0.1.1
process status navigator
apache v2 (c) 2026 l5yth

usage: psn <FILTER>
usage: psn [OPTIONS] -f <FILTER>
usage: psn [OPTIONS] -r <PATTERN>

Terminal UI for browsing process status and sending Unix signals.

Options:
  -h, --help            Show usage instructions
  -v, --version         Show version
  -f, --filter <value>  Filter process names/commands (case insensitive string)
  -r, --regex <value>   Use regex matching (regular expression pattern)
  -u, --user            Show only current user's processes

Examples:

# 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 in process list
  • 1..9: send corresponding kill signal to selected process

Development

cargo check
cargo test --all --all-features --verbose
cargo fmt --all
cargo clippy --all-targets --all-features -- -D warnings