Skip to content
CAI
Software that uses CAICheck a score

domcyrus/rustnet

78.5

Strong · 14 November 2026

79.1k

lines of production code

Rust

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add container and Kubernetes attribution for network connections

The network module now enriches connection data with container and Kubernetes metadata. On Linux, it identifies Docker, Podman, and LXC containers by parsing cgroup paths and loading runtime metadata from local disk files, and it resolves Kubernetes pod and container identities from cgroup layouts (supporting both cgroup v1 and v2). A Kubernetes resolver with Auto/On/Off modes detects if the app runs inside a pod and caches results per PID. This attribution is performed without requiring access to a runtime daemon or elevated privileges beyond what is needed for packet capture.

src/network · high confidence

Added IANA services port database

The \crates/rustnet-core/assets/services\ file has been added to the project, containing the standard IANA network services and port assignments (based on the 2021-01-19 update). This asset provides the reference data for mapping well-known TCP, UDP, and SCTP port numbers to their corresponding service names, enabling the application to identify network services by port.

crates/rustnet-core/assets · high confidence

Initial RPM packaging specification for RustNet

The RPM package specification (rustnet.spec) has been added, enabling the distribution of RustNet version 1.6.0 via RPM-based Linux distributions. This packaging includes build requirements for Rust, libpcap, and eBPF tooling, and configures the binary to run with minimal Linux capabilities (cap\_net\_raw, cap\_bpf, cap\_perfmon) for secure packet capture and process tracking. The package also installs desktop integration files, icons, and documentation, with specific build and runtime dependencies adjusted for openSUSE compatibility.

rpm · high confidence

Initial Ubuntu PPA packaging support for RustNet

RustNet is now available as a native package for Ubuntu 22.04, 24.04, and 26.04 via the \domcyrus/rustnet\ PPA. Users can install the tool using \sudo add-apt-repository ppa:domcyrus/rustnet\ and \sudo apt install rustnet\. The package includes a desktop entry, icons, shell completions, and manpages. It is built with Rust 1.88 and includes eBPF support for enhanced process detection, with capabilities automatically configured during installation to allow packet capture without requiring full root privileges.

debian · high confidence

Initial cross-platform packaging resources and Windows UTF-8 fix

This change introduces the foundational packaging assets for Linux, macOS, and Windows, including a desktop entry for Linux, an application bundle with a terminal wrapper for macOS, and a WiX installer definition for Windows. It also adds a Windows application manifest that sets the active code page to UTF-8 to prevent character encoding errors with network device descriptions, and provides documentation for generating and managing icon artwork across platforms.

resources · high confidence

Initial release of RustNet network monitor with TUI, headless, and export features

This change introduces the RustNet application, a cross-platform network monitoring tool. It provides an interactive terminal user interface (TUI) built on Ratatui, featuring live connection tracking, deep packet inspection (DPI), process attribution, and configurable color themes. For automated or remote usage, it supports a headless mode that outputs JSON snapshots or streams JSONL data, with optional filtering. The tool also includes packet capture capabilities, allowing exports to standard PCAP and annotated PCAPNG formats for analysis in tools like Wireshark. Additional features include GeoIP location lookups, reverse DNS resolution, and configurable refresh intervals. Also in this area: DPI protocol detection no longer relies on port numbers.

src · high confidence

Initial release of RustNet v1.6.0

RustNet is a cross-platform network monitoring tool featuring deep packet inspection (DPI) for protocols such as HTTP, HTTPS, DNS, SSH, FTP, QUIC, and more. It provides a terminal user interface (TUI) and a headless mode for production monitoring, with per-connection process attribution on Linux (eBPF/procfs), macOS (PKTAP/lsof), Windows (ETW/IP Helper), and FreeBSD (sockstat). The application supports PCAP/PCAPNG export, JSON logging, and runs with minimal privileges via platform-specific sandboxing (Landlock, Seatbelt, restricted tokens). Installation is available via Homebrew, Chocolatey, Scoop, PPA, COPR, and Docker.

(repo-wide) · high confidence

Introduce rustnet-host crate for cross-platform process attribution and socket inventory

The new \rustnet-host\ crate provides a unified interface for per-connection process attribution and a point-in-time host socket inventory across Linux, macOS, Windows, and FreeBSD. It exposes a \ProcessLookup\ trait that identifies the owning process (PID, name, UID/GID, executable, and lineage) using the best available OS mechanism—eBPF with procfs fallback on Linux, PKTAP/libproc on macOS, ETW on Windows, and \sockstat\/sysctl on FreeBSD. Additionally, it offers a \socket\_snapshot\ API that lists all active host sockets (including TCP listeners and UDP endpoints) with their native states, independent of captured traffic.

crates/rustnet-host · high confidence

New headless capture example and Kubernetes resolver smoke test

Added two new examples to demonstrate core capabilities without the TUI. The \headless\ example (\examples/headless.rs\) provides a low-level, machine-readable connection summary by chaining \rustnet-capture\, \rustnet-core\, and \rustnet-host\, including sandboxing and process attribution. The \k8s\_resolver\_check\ example (\examples/k8s\_resolver\_check.rs\) serves as a smoke test for Kubernetes pod and container attribution, enriching a given PID with cgroup-based metadata when built with the \kubernetes\ feature.

examples · high confidence

New modular UI architecture with tabbed layout and shared components

The terminal UI has been restructured into a modular, tabbed interface (Overview, Details, Activity, Graph, Host) using a Component pattern. This introduces a unified connection table with responsive column visibility, a clipboard system with sandbox awareness, and shared input handling for navigation and scrolling across all tabs.

src/ui · high confidence

New reusable network-analysis core library

The \rustnet-core\ crate introduces a platform-independent, reusable library for network analysis, separating packet parsing, protocol types, deep packet inspection (DPI), link-layer parsers, connection merging, and DNS/GeoIP/OUI lookups from the platform-specific capture logic. This core provides capabilities for parsing Ethernet, Linux SLL/SLL2, PKTAP, raw IP, and TUN/TAP link layers, along with IPv4/IPv6, TCP, UDP, ICMP, and IGMP. It includes DPI for HTTP, HTTPS/TLS (with SNI extraction), DNS, SSH, QUIC, NTP, mDNS, LLMNR, DHCP, SNMP, SSDP, NetBIOS, and BitTorrent. The library also features connection merging with protocol-aware lifecycle tracking, reusable filtering and retention policies, GeoIP lookups, reverse DNS with background async resolution and caching, and OUI vendor resolution.

crates/rustnet-core/src · high confidence

New utility and packaging scripts for release, testing, and asset generation

The scripts directory now includes several new tools: a log rotation script (clear\_old\_logs.sh) to manage log files, a Python script (generate-icons.py) to regenerate packaging artwork from SVG assets, and a pre-release validation script (pre-release-check.sh) that checks version consistency, changelog entries, and runs workspace-wide clippy and tests. For packaging, a new DEB packaging script (package-deb.sh) with ABI verification (verify-linux-abi.py) ensures binaries meet baseline requirements, while test scripts (test-deb-install.sh, test-package-capture.py) validate installation and capture functionality. Additionally, a PCAP enrichment script (pcap\_enrich.py) correlates packet captures with process and GeoIP sidecar data, and a demo recording script (record-rustnet-demo.sh) automates the generation of GIFs and screenshots for documentation.

scripts · high confidence

Architecture

Project restructured into a Cargo workspace with dedicated crates

The project has been refactored from a single crate into a Cargo workspace containing four distinct crates: \rustnet-core\ (network analysis, packet parsing, and DPI), \rustnet-capture\ (packet capture backend), \rustnet-host\ (process attribution and socket inventory), and \rustnet-sandbox\ (privilege dropping and sandboxing). This separation allows for better modularity, with dependencies like \libbpf-rs\ and \procfs\ now isolated in the host crate and core logic moved to the core crate, while the main binary \rustnet-monitor\ acts as the integration point.

(dependencies) · high confidence

Restructured application core into a modular src/app directory

The application's internal architecture has been reorganized from a single \src/app.rs\ file into a dedicated \src/app/\ module containing distinct components for capture, enrichment, logging, output, packet queuing, PCAPNG export, runtime lifecycle, sampling, and state management. This refactoring improves code maintainability and separation of concerns without changing the external product behavior.

src/app · high confidence

Behavioural changes

13 commits (1 fix) modifying src/headless

A change to existing behaviour in src/headless — 13 commits (1 fix), 8 files: “refactor: deduplicate tracking, parsing and output (\#699)”; “feat: add generic container attribution (\#637)”; “feat: add global capture counters (\#629)”; and 10 more (refs \#699, \#637, \#629, \#709, \#721, …).

src/headless · medium confidence · unverified

5 commits (0 fixes) modifying crates/rustnet-sandbox/src/linux, crates/rustnet-sandbox/src/macos

A change to existing behaviour in crates/rustnet-sandbox/src/linux, crates/rustnet-sandbox/src/macos — 5 commits, 5 files: “refactor: establish reusable runtime lifecycle (\#599)”; “refactor: workspace-wide dedup, dead code removal, and visibility narrowing (\#556)”; “refactor: consolidate duplicated code across the workspace (\#597)”; and 2 more (refs \#599, \#556, \#597, \#548, \#650).

crates/rustnet-sandbox/src/linux, crates/rustnet-sandbox/src/macos · medium confidence · unverified

5 commits (0 fixes) modifying crates/rustnet-sandbox/src/windows

A change to existing behaviour in crates/rustnet-sandbox/src/windows — 5 commits, 2 files: “refactor: workspace-wide dedup, dead code removal, and visibility narrowing (\#556)”; “refactor: consolidate duplicated code across the workspace (\#597)”; “docs: align guides with current behavior (\#633)”; and 2 more (refs \#556, \#597, \#633, \#721, \#548).

crates/rustnet-sandbox/src/windows · medium confidence · unverified

6 commits (1 fix) modifying crates/rustnet-sandbox/src

A change to existing behaviour in crates/rustnet-sandbox/src — 6 commits (1 fix), 3 files: “fix: secure Unix output file creation (\#651)”; “refactor: establish reusable runtime lifecycle (\#599)”; “refactor: workspace-wide dedup, dead code removal, and visibility narrowing (\#556)”; and 3 more (refs \#651, \#599, \#556, \#597, \#548, …).

crates/rustnet-sandbox/src · medium confidence · unverified

Refactored capture wait logic into platform-specific adapters

The capture wait mechanism has been restructured to use a shared \WaitPolicy\ that manages idle budgets and guards against spurious readiness, delegating to platform-specific \NativeWait\ adapters. On Unix, the adapter uses \libc::poll\ on the libpcap selectable file descriptor, while on Windows it waits on the Npcap capture event handle. This change ensures bounded, non-spinning waits and proper error handling for unsupported backends across both platforms.

crates/rustnet-capture/src · high confidence

Test coverage

Add benchmark suite for network performance; Added integration tests for platform lookups, Kubernetes resolution, and CLI startup validation; Added tests for packet capture idle behavior and readiness.

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 81 → 78 (-2.7)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 89 → 83 (-6.0)
  • Architecture 88 → 88 (-0.0)
  • Maturity 80 → 83 (+3.2)
  • Readiness 83 → 82 (-0.5)
  • Security 80 → 73 (-6.7)
  • Performance 85 → 85 (+0.0)

Resolved (15)

  • Duplicated block (10 lines × 2) (src/ui/tabs/details.rs)
  • Duplicated block (11 lines × 2) (src/ui/tabs/graph.rs)
  • Duplicated block (7 lines × 2) (crates/rustnet-core/src/network/tracker.rs)
  • Duplicated block (9 lines × 2) (src/ui/tabs/graph.rs)
  • Hotspot: src/app/logging.rs (src/app/logging.rs)
  • Hotspot: src/ui/connection_table.rs (src/ui/connection_table.rs)
  • LinuxProcessLookup::parse_and_map_content (cognitive 16) (crates/rustnet-host/src/linux/process.rs)
  • MethodTooLong: ConnectionSnapshot.from_connection (src/headless/schema.rs)
  • No ADRs found
  • pcap_enrich.create_pcapng (cognitive 30) (scripts/pcap_enrich.py)
  • pcap_enrich.create_pcapng (cyclomatic 16) (scripts/pcap_enrich.py)
  • pcap_enrich.find_matching_connection (cognitive 17) (scripts/pcap_enrich.py)
  • pcap_enrich.load_connections (cognitive 16) (scripts/pcap_enrich.py)
  • pcap_enrich.print_table (cognitive 16) (scripts/pcap_enrich.py)
  • rustnet_monitor::app::unix_output::parent_dir (cognitive 19) (src/app/unix_output.rs)

New (26)

  • Duplicated block (11 lines × 2) (src/ui/tabs/graph.rs)
  • Duplicated block (7 lines × 2) (crates/rustnet-core/src/network/dns.rs)
  • Duplicated block (9 lines × 2) (crates/rustnet-host/src/linux/lifecycle.rs)
  • Edited copy of a member (10 corresponding lines) (src/ui/theme/derive.rs)
  • Edited copy of a member (11 corresponding lines) (src/app/output/unix.rs)
  • Edited copy of a member (12 corresponding lines) (src/ui/theme/mod.rs)
  • Edited copy of a member (14 corresponding lines) (crates/rustnet-host/src/freebsd/process.rs)
  • Edited copy of a member (15 corresponding lines) (crates/rustnet-core/src/network/link_layer/raw_ip.rs)
  • Edited copy of a member (15 corresponding lines) (crates/rustnet-host/src/freebsd/process.rs)
  • Edited copy of a member (16 corresponding lines) (crates/rustnet-host/src/linux/ebpf/tracker_libbpf.rs)
  • Edited copy of a member (19 corresponding lines) (crates/rustnet-core/src/network/types/rtt.rs)
  • Edited copy of a member (29 corresponding lines) (crates/rustnet-core/src/network/dpi/tls_common.rs)
  • Edited copy of a member (8 corresponding lines) (src/export/pcapng.rs)
  • FileTooLong: headless/schema.rs (src/headless/schema.rs)
  • FileTooLong: linux/process.rs (crates/rustnet-host/src/linux/process.rs)
  • FunctionTooLong: rustnet_monitor::connection_details::visit_application_fields (src/connection_details.rs)
  • Hotspot: crates/rustnet-core/src/network/dns_analytics.rs (crates/rustnet-core/src/network/dns_analytics.rs)
  • IncrementalEncoder::serialize_connections (cognitive 21) (src/headless/schema/incremental.rs)
  • Medium advisory (unsound): RUSTSEC-2026-0486 (Cargo.lock)
  • MethodTooLong: ConnectionSnapshot.from_connection_with_process (src/headless/schema.rs)
  • …and 6 more

Changes since last survey

  • 30 commits — 26 feature/other, 4 fixes

By area

  • (root) — 20 commits
  • .github/workflows — 4 commits
  • crates/rustnet-core — 2 commits
  • src/headless — 2 commits
  • src/ui — 2 commits

Notable commits

  • fix: Fix DNS validation and STUN detection on port 53 (#722)
  • fix: fix(ci): replace retired macOS 14 runners with macOS 15 (#717)
  • fix: fix(deps): update zstd dependencies to patched releases (#701)
  • fix: fix: discard pending RTT probes on TCP keepalives (#716)
  • change: Add headless snapshot profiling and controlled baselines (#720)
  • change: Add incremental headless JSONL (#719)
  • change: Do not count one-byte TCP keepalive probes as loss (#714)
  • change: Extend headless metadata and CLI automation (#721)
  • change: Limit Npcap ZIP features (#718)
  • change: Update OUI vendor database (#708)
  • change: chore(deps): bump debian from a29215f to a72b443 in the docker group (#729)
  • change: chore(deps): bump docker/login-action (#700)
  • change: chore(deps): bump docker/login-action (#723)
  • change: chore(deps): bump log (#711)
  • change: chore(deps): bump the rust-dependencies group with 2 updates (#724)
  • change: chore(deps): bump the rust-dependencies group with 3 updates (#725)
  • change: chore(deps): bump zip from 9.0.5 to 9.1.0 in the rust-dependencies group (#703)
  • change: chore(deps): bump zip from 9.1.0 to 9.1.2 in the rust-dependencies group (#704)
  • change: chore(deps): bump zip from 9.1.2 to 9.1.3 in the rust-dependencies group (#710)
  • change: chore(deps): bump zip from 9.1.3 to 9.2.0 in the rust-dependencies group (#712)
  • …and 10 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

domcyrus/rustnet was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 09d7fbf152c7a7d3dc688602ca8c67904c28a5c2 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-36d4cd83012f.