# proxyman-https-capture

proxyman-https-capture sets up HTTPS capture in Proxyman on desktop, iOS and Android, then narrows down why traffic stays invisible.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 274 installs · ★ 24 repo stars
- 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-https-capture/SKILL.md
- Updated: 2026-08-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/proxyman-https-capture

## What it does

The skill walks through HTTPS capture setup in Proxyman and fixes the cases where it breaks: desktop systems, Apple devices and simulators, Android, browsers, terminal runtimes, containers, HTTP clients. It starts by collecting context: host OS and app version, physical target or emulator, debug or production build, VPN or certificate pinning in the way. It will not install certificates, change the system proxy or restart a target without approval.

Normal capture rests on three independent pieces: traffic routed through Proxyman, the target trusting the right root CA, and SSL Proxying enabled for the host. A trusted certificate says nothing about routing, so the diagnosis runs in order: reachability, routing, recording, trust, SSL Proxying, then app behavior. When only some libraries go missing, they probably skip the system proxy or keep a separate trust store.

Through MCP the skill checks `get_version` and `get_proxy_status`, narrows the target with `answer_setup_question`, reads `get_certificate_status` and `get_ssl_proxying_list`, and runs `run_guided_setup` or `install_certificate` only after you agree. Verification uses `filter_flows` and `get_flow_detail`. Without a running Proxyman MCP server that branch does nothing, so `proxyman-mcp-setup` comes first. Atlantis is the other route: an instrumentation library inside an app you control forwards traffic to Proxyman with no proxy, CA or SSL Proxying steps.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ProxymanApp/proxyman-SKILL.md skills/proxyman-https-capture
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- route a phone's traffic through Proxyman and get its CA trusted
- work out why HTTP shows up but HTTPS stays opaque
- install the root CA into a booted Apple simulator
- capture requests from a Docker container through the host address instead of `127.0.0.1`
- handle an Android app that rejects a user CA

## Example prompts
- Set up HTTPS capture in Proxyman for an app running in the iOS simulator
- HTTP flows show up in Proxyman but HTTPS stays encrypted, walk the checklist and tell me what to fix
- Requests from my Docker container never reach Proxyman, sort out the routing

## Similar
- [mobile-app-debugging](https://affpapa.org/en/nevibecode/skills/secondsky-mobile-app-debugging.md) — skill · 446 installs
- [Cloak Proxy](https://affpapa.org/en/nevibecode/mcp/cloak-proxy.md) — MCP server
- [debugging-surveys](https://affpapa.org/en/nevibecode/skills/debugging-surveys.md) — skill · 197 installs
- [debug-extension](https://affpapa.org/en/nevibecode/skills/debug-extension.md) — skill · ★ 1167 repo stars
- [asc-signing-setup](https://affpapa.org/en/nevibecode/skills/asc-signing-setup.md) — skill · 7700 installs
- [mobile-debugging](https://affpapa.org/en/nevibecode/skills/mobile-debugging.md) — skill · 176 installs

From the same set: [proxymanapp/proxyman-skill.md](https://affpapa.org/en/nevibecode/by/proxymanapp/proxyman-skill.md.md) — 9 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
