Skip to content

v0.1.0 — Phase 1: stdio shim + protocol tee

Choose a tag to compare

@tstefank tstefank released this 08 Jun 13:31
· 30 commits to main since this release

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 view

What'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), summarizes initialize / tools/list / roots/list results, 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/pounce

Verify 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.