claude-tap CLI
A local proxy and trace viewer for coding agents: shows system prompts, tool calls and token usage for Claude Code, Codex and other CLIs
- 3,336 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Intercepts the coding agent's network traffic through a local proxy
- Some modes require trusting a local CA certificate
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/claude-tapDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Intercepts the coding agent's network traffic through a local proxy
- Some modes require trusting a local CA certificate
This is third-party code. Review the repository files before installing.
What it does
claude-tap wraps around a coding agent and intercepts its network traffic locally, without sending anything off the machine. The viewer shows the system prompt, message history, tool schemas and calls, streamed responses, and token usage per request. It can diff two adjacent requests line by line to show exactly what changed in the context between agent turns. Each session is saved as a self-contained HTML file that can be shared without running claude-tap again.
Who it is for. For developers debugging coding-agent behavior who want to see the actual model request instead of guessing at it.
Good fit when
- You need to understand why an agent behaved unexpectedly by checking its real context
- You need to compare what changed in the prompt between two consecutive requests
- You need to measure token usage for a specific session
- You route through a custom gateway like DeepSeek or AWS Bedrock and want to verify what actually goes out
Not a fit when
- You only need a usage summary, not full request tracing
- You work with a client claude-tap does not support intercepting (check the supported list)
Example request
Run Claude Code through claude-tap and show what changed in the system prompt between the last two requestsLimitations
Requires Python 3.11 and the client you want to trace already installed. Some clients (Gemini CLI, OpenCode, Pi, Hermes Agent) use forward-proxy mode, which intercepts all of the process's traffic, not just model requests. On macOS, some clients require trusting a local CA certificate in the user login keychain.
How to disable. Just run the agent directly instead of through claude-tap; remove the package with uv tool uninstall claude-tap or pip uninstall claude-tap.
FAQ
Does data leave my machine?
No, the viewer runs locally, traces are stored on disk, and common auth headers are redacted before they are recorded.
Which agents does it work with?
Claude Code, Codex CLI and App, Gemini CLI, Grok Build CLI, Kimi CLI, OpenCode, Pi, Hermes Agent, Cursor CLI, Qoder CLI, Antigravity CLI, CodeBuddy CLI and a few others — the full list is in the README.
Discussion
No questions or reviews yet.
Related
CLI toolsA Harbor fork for evaluating coding agents in sandboxes: Claude Code, Codex and others run inside tasks with no internet.
Local review of your AI agent runs: checks, traces and call replay, with Claude Code and Codex getting 23 MCP tools.
A skill that teaches Claude Code and Cursor to wire in Tracely tracing and turn failing agent runs into CI tests
tapflow MCP server: an agent controls iOS simulators and Android emulators on your Mac and replays flows for CI
A performance CLI that lets an agent compare branches, find slow spots and confirm a speedup with numbers.
agentevals scores AI agent behavior from OpenTelemetry traces and ships MCP tools plus the /eval and /inspect skills.
README in short
The README describes claude-tap as a local proxy and trace viewer for coding agents, distributed via PyPI. It supports over a dozen clients through reverse- and forward-proxy modes, while Cursor is handled by watching transcripts without traffic interception. The viewer ships as a single self-contained HTML file with a structural diff, search, token usage breakdown, dark mode and several interface languages. Separate guides cover routing Claude Code through the DeepSeek API and AWS Bedrock. MIT licensed.