nifa 0.5.0

Cross-platform network inspection tool
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

[crates-badge]: https://img.shields.io/crates/v/nifa.svg
[crates-url]: https://crates.io/crates/nifa
[license-badge]: https://img.shields.io/crates/l/nifa.svg

# nifa [![Crates.io][crates-badge]][crates-url] ![License][license-badge]

Cross-platform network inspection tool.

It is designed for Linux, macOS, and Windows with a consistent command surface:

```bash
nifa <sub-command> [options]
```

With no sub-command (`nifa`), it shows the primary network interface summary.

## Principles

- Read-only only: no mutation commands
- Tree-first output (`tree` default)
- Structured output for automation (`json` / `yaml`)

## Supported Platforms
- **Linux**
- **macOS**
- **Windows**

## Installation

### Install prebuilt binaries via shell script

```sh
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/shellrow/nifa/releases/latest/download/nifa-installer.sh | sh
```

### Install prebuilt binaries via powershell script

```sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/shellrow/nifa/releases/latest/download/nifa-installer.ps1 | iex"
```

### From Releases
You can download precompiled binaries from the [releases](https://github.com/shellrow/nifa/releases) 

### Using Cargo

```sh
cargo install nifa
```

## Commands

```text
if      Network interfaces
addr    IP addresses
link    Layer 2 information
route   Routing table
neigh   ARP / NDP entries
sock    Sockets (ss/netstat equivalent)
sys     Network/system summary
mon     TUI monitor
```

## Output Options

All non-TUI commands support:

```text
--format tree|table|json|yaml
--wide
--no-color
--no-truncate
```

### Format behavior

- Default: `tree`
- Use `--format table` for tabular output

## Examples

```bash
# Interfaces (summary)
nifa if

# Interface details
nifa if show en0

# Addresses
nifa addr
nifa addr --iface en0 --ipv6

# Link layer
nifa link --up

# Routes
nifa route --default
nifa route --ipv4 --detail

# Neighbors
nifa neigh --ipv4 --vendor

# Sockets
nifa sock --proto tcp --listen
nifa sock --proto tcp --established --pid

# System summary
nifa sys
nifa sys --dns
nifa sys --proxy

# TUI monitor
nifa mon --iface en0 --interval 1 --sort total
```