Repository navigation
v0.2.0 — OS ground truth: per-process network capture
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 timeline13: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)
pounceddaemon (sudo pounce daemon): runs the systemtcpdumpon thepktappseudo-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
wrapshim stays unprivileged and just reports its child PID subtree; the socket verifies peer credentials (LOCAL_PEERCRED). No daemon running →wrapbehaves exactly as in v0.1.x. viewinterleaves 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/pounceVerify 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