psn 0.1.2

Terminal UI for process status navigation and control
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

<!-- Copyright (c) 2026 l5yth -->
<!-- SPDX-License-Identifier: Apache-2.0 -->

# psn

[![Rust](https://github.com/l5yth/psn/actions/workflows/rust.yml/badge.svg)](https://github.com/l5yth/psn/actions/workflows/rust.yml)
[![Codecov](https://codecov.io/gh/l5yth/psn/graph/badge.svg)](https://codecov.io/gh/l5yth/psn)
[![GitHub Release](https://img.shields.io/github/v/release/l5yth/psn)](https://github.com/l5yth/psn/releases)
[![Crates.io](https://img.shields.io/crates/v/psn.svg)](https://crates.io/crates/psn)
[![AUR Version](https://img.shields.io/aur/version/psn-bin?logo=archlinux)](https://aur.archlinux.org/packages/psn-bin)
[![Nix Flake](https://img.shields.io/badge/nix-flake-5277C3?logo=nixos)](https://github.com/l5yth/psn/blob/main/flake.nix)
[![Gentoo](https://img.shields.io/badge/gentoo-ebuild-54487A?logo=gentoo)](https://github.com/l5yth/psn/tree/main/packaging/gentoo)
[![Top Language](https://img.shields.io/github/languages/top/l5yth/psn)](https://github.com/l5yth/psn)
[![License: Apache-2.0](https://img.shields.io/github/license/l5yth/psn)](https://github.com/l5yth/psn/blob/main/LICENSE)

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

![psn TUI overview](assets/images/psn-tui-overview.png)

- [x] Browse running processes in a terminal UI
- [x] Filter processes by text match `<FILTER>` or regular expression `-r <PATTERN>`
- [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

## 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](./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.2
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:

```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)
- `1`..`9`: send corresponding signal to selected process (prompts for confirmation)

## Development

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