prt 0.6.0

Live network port inspector for macOS and Linux with process details, SSH tunnel health, alerts and JSON/CSV export
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

# prt

[![Crates.io](https://img.shields.io/crates/v/prt.svg)](https://crates.io/crates/prt)
[![CI](https://github.com/rekurt/prt/actions/workflows/ci.yml/badge.svg)](https://github.com/rekurt/prt/actions/workflows/ci.yml)
[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/rekurt/prt/blob/master/LICENSE)

`prt` is a real-time terminal interface for discovering which processes own network ports on macOS and Linux. It adds filtering, lifecycle tracking, process details, network topology, SSH tunnels, alerts, and automation-friendly output to the usual `lsof` or `/proc` snapshot.

<img src="https://raw.githubusercontent.com/rekurt/prt/master/docs/prt.gif" alt="Animated prt demo showing live connections, process details, topology, command palette, and contextual actions" width="960">

[View a static demo frame](https://github.com/rekurt/prt/blob/master/docs/prt-demo.png) · [Read the demo transcript](https://github.com/rekurt/prt/blob/master/docs/demo-transcript.md) · [Open the full documentation](https://github.com/rekurt/prt#readme)

## Install

```sh
cargo install prt --version 0.6.0 --locked
prt
```

Requirements: Rust 1.88+ for Cargo installation; macOS 10.15+ with `lsof`, or Linux with `/proc`.

Homebrew: `brew install rekurt/tap/prt`. Linux x86_64 DEB/RPM and archives for Linux/macOS are available in [v0.6.0](https://github.com/rekurt/prt/releases/tag/v0.6.0); Linux binaries require glibc 2.35+. Verify downloads against the release `SHA256SUMS`.

SSH tunnels support editing, real status, uptime, listener health (including intermittent flapping), command copying, and automatic reconnect.

## Command-line modes

```sh
prt                         # interactive TUI
prt --lang ru               # language: en, ru, or zh
prt --export json           # one JSON snapshot
prt --export csv            # one CSV snapshot
prt --json                  # continuous NDJSON stream
prt watch 80 443            # compact port monitor
sudo prt                    # include processes hidden from this user
```

Use `--export` for a finite snapshot and `--json` for a continuous stream.

## Interface

- `Tab` / `Shift+Tab`: Connections, Processes, and SSH sections
- `?`: complete in-app help
- `:`: searchable command palette
- `/`: search and filter
- `Space`: contextual actions
- `Enter`: open the selected process
- `d`: toggle the Connections details panel
- `[` / `]`: switch Processes or SSH sub-tabs
- `p`: pause or resume automatic refresh
- `L`: switch language

The TUI is keyboard-driven. A static preview and text transcript are provided for readers who prefer not to view an autoplaying animation. JSON, CSV, NDJSON, and watch modes provide non-full-screen alternatives.

## Crate layout

This binary crate contains the clap CLI, ratatui interface, input handling, NDJSON and watch modes, system-call tracing, and SSH tunnel management. Scanning and domain logic live in [`prt-core`](https://crates.io/crates/prt-core).

## License

[MIT](https://github.com/rekurt/prt/blob/master/LICENSE)