# http-toolkit-intercept

http-toolkit-intercept captures HTTP requests and responses from any script or service — including LLM API calls, backend requests, and auth flows. Use it when you need to see what's actually sent over the wire and what comes back.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 124 installs · ★ 129 repo stars
- Author: Factory-AI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Factory-AI/factory-plugins/tree/HEAD/plugins/debugging/skills/http-toolkit-intercept/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/http-toolkit-intercept

## What it does

This skill integrates HTTP Toolkit into a running process to inspect all network traffic. It works with Node.js, Python, Go, Java, Ruby, .NET, Rust, curl, and other runtimes that respect proxy environment variables. The typical workflow is: start HTTP Toolkit, run your program through the proxy at `http://127.0.0.1:8000` with `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` set, capture the program's structured logs (if it supports `--output-format json` or similar), export the HTTP session from Toolkit, and cross-reference the two.

On Linux headless systems, use `xvfb-run --auto-servernum httptoolkit --no-sandbox` to avoid X11 sandbox errors. Each runtime has its own proxy quirks: Bun ignores standard env vars and requires `BUN_CONFIG_PROXY`; Java needs JVM flags `-Dhttp.proxyHost` and `-Dhttp.proxyPort` at startup. TLS verification is on by default — disable it with `NODE_TLS_REJECT_UNAUTHORIZED=0` or runtime-specific equivalents only for local debugging when the HTTP Toolkit CA is not in your system trust store.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill http-toolkit-intercept -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/http-toolkit-intercept/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/http-toolkit-intercept/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill http-toolkit-intercept -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/http-toolkit-intercept/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill http-toolkit-intercept -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/http-toolkit-intercept/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Factory-AI/factory-plugins plugins/debugging/skills/http-toolkit-intercept
```

2. **Manually: put the files in place**
- File: `.github/skills/http-toolkit-intercept/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill http-toolkit-intercept -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Factory-AI/factory-plugins --path plugins/debugging/skills/http-toolkit-intercept
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/http-toolkit-intercept/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill http-toolkit-intercept -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Factory-AI/factory-plugins/tree/HEAD/plugins/debugging/skills/http-toolkit-intercept/SKILL.md

## When to use it
- inspect API calls to LLM services during integration development
- trace request payloads and headers in complex network flows
- debug authentication failures and auth header issues
- verify what data leaves your application before production deployment
- gather evidence of HTTP client behavior across different runtimes

## Example prompts
- Capture HTTP requests from a Python script calling Claude API and examine headers and body content
- Run a Node.js app through HTTP Toolkit proxy and export logs in JSON to verify what data goes to your backend
- Debug a Go service by routing traffic through the proxy and matching outbound requests to application logs

## Similar
- [hunt-http-smuggling](https://affpapa.org/en/nevibecode/skills/hunt-http-smuggling.md) — skill · ★ 16193 repo stars
- [extension-http-outcalls](https://affpapa.org/en/nevibecode/skills/extension-http-outcalls.md) — skill · 32200 installs
- [network-request-auditing](https://affpapa.org/en/nevibecode/skills/network-request-auditing.md) — skill · 479 installs
- [http-parameter-pollution](https://affpapa.org/en/nevibecode/skills/http-parameter-pollution.md) — skill · 4000 installs
- [http-host-header-attacks](https://affpapa.org/en/nevibecode/skills/http-host-header-attacks.md) — skill · 4000 installs
- [http-request-smuggling](https://affpapa.org/en/nevibecode/skills/http-request-smuggling.md) — skill · ★ 73 repo stars

From the same set: [factory-ai/factory-plugins](https://affpapa.org/en/nevibecode/by/factory-ai/factory-plugins.md) — 17 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
