Main
Use it as a cross-client debugger: README lists multiple supported coding CLIs and shows how to switch via
--tap-client.Turn on live mode when you need to inspect traces while the agent is running (
--tap-livein README).Capture first, optimize later: use traces to identify prompt bloat, tool misuse, and token spikes before changing your agent policies.
Source-backed notes
- README says it intercepts API traffic from Claude Code, Codex CLI, Gemini CLI, OpenCode, and Cursor CLI and visualizes traces.
- README recommends install via
uv tool install claude-tapand also supportspip install. - README documents usage examples like
claude-tap --tap-client codexand forwarding args after--.
FAQ
- Do I need to modify my CLI tools?: No — README shows running clients through
claude-tapwithout patching them. - Can I trace Codex CLI OAuth mode?: Yes — README notes Codex auth modes and shows examples; you may set a target explicitly if needed.
- What Python version is required?: README lists Python 3.11+ for installation and usage.