Skip to content

v0.2.0 — OS ground truth: per-process network capture

Choose a tag to compare

@tstefank tstefank released this 12 Jun 12:17
· 20 commits to main since this release

The first release with OS ground truth. Beyond the declared tool calls (Phase 1), pounce can now show the actual per-process network activity those calls cause — attributed to the wrapped server's PID subtree.

sudo pounce daemon        # opt-in privileged capture: root, NO Full Disk Access
pounce wrap -- <server>   # auto-reports its subtree to the daemon; no privilege
pounce view               # network events interleaved into the timeline
13:01:28.517 · net  tcp 104.20.23.154:443  out  curl pid 50592   ← the connection a tool caused

What's new (Phase 2 — network tier)

  • pounced daemon (sudo pounce daemon): runs the system tcpdump on the pktap pseudo-interface as root, attributes every connection to a session's PID subtree, and streams it back over a local Unix socket. One capture stream serves all wrap sessions. Root-only, no FDA.
  • Privilege split per the design: the client-launched wrap shim stays unprivileged and just reports its child PID subtree; the socket verifies peer credentials (LOCAL_PEERCRED). No daemon running → wrap behaves exactly as in v0.1.x.
  • view interleaves network events into the timeline and records capture provenance (tcpdump/macOS versions).
  • Hardened attribution: anchored parsing, IPv6, and fail-safe-to-"attribution unavailable" with a drift counter + a live CI self-check, so a future tcpdump/macOS format change trips CI, not users.
  • Also includes the v0.1.x line: tool-execution-error surfacing, and a wrap stdin-hang fix.

A note on the capture mechanism (macOS 26)

Network attribution needs a per-packet PID. On macOS 26 / tcpdump Apple-158 the binary paths don't expose it: the public libpcap API cannot enable DLT_PKTAP (confirmed with a pure-C probe — not a Go bug), and written pcap/pcapng drops the pid. So pounce reads the pid from the system tcpdump's text pktap metadata (-k NP) — same kernel pid — with strict, drift-guarded parsing. Details and the future raw-BPF option are recorded in the repo.

Install

Static binaries, no dependencies. Download for your Mac, then:

chmod +x pounce-darwin-arm64   # or -amd64 on Intel
xattr -d com.apple.quarantine pounce-darwin-arm64   # if Gatekeeper blocks it
mv pounce-darwin-arm64 /usr/local/bin/pounce

Verify with shasum -a 256 -c checksums.txt. Or build from source: go build -o pounce ./cmd/pounce.

Not included

File/exec capture via eslogger (Phase 4: root + FDA) and intent↔effect correlation (Phase 3) — next on the roadmap. Linux is later.

Full changelog: v0.1.1...v0.2.0