proxyman-https-capture — Claude Code skill: HTTPS capture setup
proxyman-https-capture sets up HTTPS capture in Proxyman on desktop, iOS and Android, then narrows down why traffic stays invisible.
no license 274 installs ★ 24 updated 2026-08-21
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture -a claude-codeWhat proxyman-https-capture 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.
What it helps with
- 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 for the agent
- 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
How to install proxyman-https-capture
1Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture -a claude-code2Manually: put the files in place
~/.claude/skills/proxyman-https-capture/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/proxyman-https-capture/
1Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture -a codex2Manually: put the files in place
.agents/skills/proxyman-https-capture/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture -a cursor2Manually: put the files in place
.cursor/skills/proxyman-https-capture/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ProxymanApp/proxyman-SKILL.md skills/proxyman-https-capture2Manually: put the files in place
.github/skills/proxyman-https-capture/SKILL.md1Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture -a gemini-cli2Platform CLI
gemini skills install https://github.com/ProxymanApp/proxyman-SKILL.md --path skills/proxyman-https-captureManually: put the files in place
.devin/skills/proxyman-https-capture/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about proxyman-https-capture
How do I install proxyman-https-capture in Claude Code?
Run npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture -a claude-code. The skill file lands at ~/.claude/skills/proxyman-https-capture/SKILL.md.
What does proxyman-https-capture do?
It picks the least invasive capture path for your device or runtime and walks the diagnosis in order: reachability, routing, recording, CA trust, SSL Proxying, app behavior.
How is Atlantis different from normal proxy capture?
Atlantis instruments an app you control and forwards its traffic to Proxyman without routing through the proxy or trusting the CA. It has separate limits and its own verification, and it helps when a VPN blocks the normal proxy on iOS.