gitwtfhub

wtf is agent-wiretap?

unable12/agent-wiretap — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A local proxy tool that shows you live, in your terminal, every file, secret, and website your AI coding agent sends over the network.

Mindmap

mindmap
  root((agent-wiretap))
    What it does
      Watches agent traffic
      Flags leaked secrets
      Shows contacted domains
    Tech stack
      TypeScript
      Node 22 plus
      Local HTTPS proxy
    How it works
      Local CA certificate
      Proxy env vars
      Passthrough unmodified
    Modes
      Wrapper mode
      Ambient dashboard mode
    Use cases
      Catch secret leaks
      Audit agent traffic
      Estimate token cost

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Watch exactly which files an AI coding agent reads or writes during a session.

REASON 2

Catch accidental leaks of API keys, tokens, or .env files before they leave your machine.

REASON 3

See every domain a coding agent contacts, with request counts and byte totals.

REASON 4

Get an estimated dollar cost of a coding agent session based on token usage.

What's in the stack?

TypeScriptNode.jsCLIHTTPS proxy

How it stacks up

unable12/agent-wiretapaliansari22/pdfclearamalshaji/cafeblr
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedevelopergeneralvibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires Node 22 or newer, runs instantly via npx with no install step.

MIT licensed: free to use, modify, and redistribute, including commercially, as long as the copyright notice is kept.

Wtf does this do

agent-wiretap is a local tool that lets you watch exactly what your AI coding agent sends over the internet while it works. If you have given an agent like Claude Code or Codex access to your files and an API key, this tool shows you, live in your terminal, every file it reads or writes, every shell command it runs, every website it talks to, and any secrets like API keys or passwords that show up in that traffic. Nothing captured is sent anywhere else. Everything stays on your own machine, and none of the traffic itself is written to disk, only decoded in memory and shown to you. You run it with a single command using npx and no separate install step, requiring Node version 22 or newer. You can either wrap your agent so it runs normally with its usual interface while agent-wiretap watches quietly in the background and prints a summary when it finishes, or you can run it in a mode that takes over your terminal to show a live dashboard while your agent runs in a second terminal window. Under the hood, the tool works by generating a local security certificate and starting a proxy on your machine, then setting standard environment variables that tell your coding agent to route its internet traffic through that proxy and trust the certificate. This lets the tool decode encrypted web traffic just long enough to inspect it before passing every request through to its real destination completely unmodified. Nothing is blocked or delayed. The dashboard also flags common secret patterns such as AWS keys, private key files, GitHub and Slack tokens, and sensitive filenames like .env files, and it estimates how much your agent's usage would cost at standard pay as you go API pricing, though this is only an estimate and does not actually charge you anything. The project is written in TypeScript, includes a test suite, and is released under the MIT license.

Yoink these prompts

Prompt 1
Show me how to run my Claude Code session through agent-wiretap using npx.
Prompt 2
Explain the difference between wrapper mode and ambient mode in agent-wiretap.
Prompt 3
Walk me through how agent-wiretap intercepts HTTPS traffic using a local certificate authority.
Prompt 4
Help me understand what secret patterns agent-wiretap scans for in outbound traffic.

Frequently asked questions

wtf is agent-wiretap?

A local proxy tool that shows you live, in your terminal, every file, secret, and website your AI coding agent sends over the network.

What language is agent-wiretap written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, CLI.

What license does agent-wiretap use?

MIT licensed: free to use, modify, and redistribute, including commercially, as long as the copyright notice is kept.

How hard is agent-wiretap to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agent-wiretap for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.