# proxyman-traffic-debugging

This skill wires your agent to a running Proxyman over MCP, so it can read requests, filter flows, add debugging rules and replay calls.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 490 installs · ★ 22
- Author: ProxymanApp
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ProxymanApp/proxyman-SKILL.md/tree/HEAD/skills/proxyman-traffic-debugging/SKILL.md
- Updated: 2026-08-21
- HTML: https://affpapa.org/en/nevibecode/skills/proxyman-traffic-debugging

## What it does

The skill treats Proxyman MCP as a local control plane for the app you already have open. Your MCP client starts Proxyman's bundled `mcp-server` over stdio; that bridge performs a local handshake and passes calls to an authenticated server inside the running app. You never hardcode the HTTP port or token, and each bridge stays alive only while its stdin is open.

Every session follows the same opening: discover tools and resources, call `get_version`, then `get_proxy_status` for recording state, proxy port and SSL Proxying. From there the agent narrows candidates with `get_flows` or `filter_flows`, reads details through `get_flow_detail`, and returns a verdict — passed, suspicious, failed or inconclusive — backed by flow IDs. Before any mutation it states what the change touches: capture, certificate trust, traffic or disk. Then it verifies with a read call.

Flow lists are snapshots. A flow ID can vanish after a clear, an import, a source switch or a restart. `get_flows` and `filter_flows` cap out at 500 results and body previews may be cut short, so full archival data needs an export to a destination you approve. MCP redaction covers common secret headers, cookies and JWTs, yet it does not sanitize the original HAR written by `export_flows` — treat those files as sensitive. System proxy, Terminal injection and Electron `.app` injection are mostly macOS operations; on Windows and Linux rely on live tool discovery.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-traffic-debugging -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-traffic-debugging -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-traffic-debugging -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ProxymanApp/proxyman-SKILL.md proxyman-traffic-debugging
```

2. **Manually: put the files in place**
- File: `.github/skills/proxyman-traffic-debugging/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-traffic-debugging -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ProxymanApp/proxyman-SKILL.md --path skills/proxyman-traffic-debugging
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-traffic-debugging -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/ProxymanApp/proxyman-SKILL.md/tree/HEAD/skills/proxyman-traffic-debugging/SKILL.md

## When to use it
- locate one request among hundreds of captured flows
- explain a failing API call from status codes and timing
- filter traffic from a specific device or simulator
- add a Breakpoint or Map Local rule and confirm it works
- export a flow to HAR for offline analysis

## Example prompts
- Show the latest flows to api.example.com and tell me which ones failed
- Filter traffic from the simulator and walk me through the slowest request
- Create a Map Local rule for this URL and confirm it is enabled

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

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