# matthart1983/netwatch

> netwatch is a terminal tool for real-time network diagnostics. It captures live traffic and socket connections, decodes application protocols, and shows the results in interactive views. Its Diagnose tab opens an issue when a learned baseline breaks, and the project is written in Rust.

Source: https://github.com/matthart1983/netwatch
Indexed: commit 6e28232 on 2026-09-21 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Rust
- Stars: 3,596 at index time
- License: MIT
- Code health: 4.2/10, Needs_work
- Last commit: 2026-09-20
- Contributors: 6

## Install

From the README: https://github.com/matthart1983/netwatch#install

Install netwatch with Homebrew on macOS or Linux.
    brew install netwatch

## How to use

Run netwatch with sudo to enable capture where elevated access is required.
    sudo netwatch

## How it works

Startup, configuration and the event loop are handled in src/app.rs, the main entry point, while src/cli.rs parses options such as --lite and --view dense. The modules in src/collectors gather raw data, and src/collectors/connections.rs tracks sockets with their process, state and RTT, while src/collectors/egress.rs records destinations for egress linting. The diagnose code in src/diagnose, started through src/diagnose/run.rs, compares observations against learned baselines and follows each issue until a fix is verified. The views are drawn by files such as src/ui/dashboard.rs and src/ui/packets.rs, which render the Dashboard and Packets tabs from the shared state.

- src/app.rs: entry point
- src/cli.rs: entry point
- src/diagnose/run.rs: entry point
- src/lib.rs: entry point
- src/main.rs: entry point
Modules: src, examples, scripts, tests, ml, packaging, completions, root. 201 files, 78,961 lines, 7,179 symbols.

## Code health

- Score: 4.2/10 (Needs_work)
- Rank: #247 of 4,000+ indexed repos
- Hotspots: src/app.rs, src/collectors/egress.rs, src/ui/dashboard.rs, src/collectors/connections.rs, src/ui/packets.rs
- Lowest file: src/ui/topology.rs
- Dead code: 2 findings

## Maintenance

- Last commit 2026-09-20, first commit 2026-02-26, 396 commits
- 6 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/matthart1983/netwatch/security

## More

- Page: https://repowise.dev/repo/matthart1983/netwatch
- Ask this codebase: https://repowise.dev/repo/matthart1983/netwatch/chat
- Docs: https://repowise.dev/repo/matthart1983/netwatch/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/matthart1983/netwatch
