Repository navigation
v0.1.0 — Phase 1: stdio shim + protocol tee
First release of pounce — ground truth for what AI coding agents and MCP servers actually do.
Wrap any MCP server in one line and see every JSON-RPC tool call it makes. Observe-only: the bytes between client and server are forwarded byte-for-byte, so the wrapped server behaves exactly as if pounce weren't there.
pounce wrap -- npx -y @modelcontextprotocol/server-filesystem /tmp
pounce viewWhat's in this release (Phase 1)
wrap— transparent stdio tee: launches the real MCP server, forwards stdin/stdout/stderr unchanged, and records every JSON-RPC message to~/.pounce/sessions/<id>.jsonl.view— replays the session as a tool-call timeline: pairs each request with its response (direction-aware id matching), summarizesinitialize/tools/list/roots/listresults, with optional ANSI color.- Newline-delimited JSON-RPC 2.0 parsing confirmed against the MCP 2025-06-18 spec; handles legacy batch frames.
- Architected so an HTTP/SSE proxy and a log/hook ingester can slot in behind the same intent-source interface later.
No privileges required. macOS-first.
Install
Download the binary for your Mac below, 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.
Binaries are unsigned (Phase 5 will add notarized/Homebrew packaging). Not yet on a Homebrew tap.
Not in this release
OS-level capture (files/network/processes) and intent↔effect correlation — see the roadmap in the README. Linux support is later too; these are darwin/amd64 + darwin/arm64 only.