# proxyman-download-setup

This skill checks for Proxyman, installs it, launches it, and prepares the app before MCP setup on macOS, Windows, or Linux.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 337 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-download-setup/SKILL.md
- Updated: 2026-08-21
- HTML: https://affpapa.org/en/nevibecode/skills/proxyman-download-setup

## What it does

The skill walks an agent through detecting an existing Proxyman installation, fetching the current release, and opening the app. macOS can use Homebrew or a DMG, Windows uses PowerShell and its installer, and Linux uses an executable AppImage.

It also locates the MCP bridge exposed by the application. On Windows and Linux, Proxyman must be opened before MCP configuration because the first launch prepares that bridge. The MCP command is the bundled `mcp-server` or `mcp-server.exe`, not the main application binary.

Installation does not set up every traffic target. CLI programs, localhost requests, and HTTPS capture can require separate Proxyman modes, which belong to the follow-up capture workflow.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- check whether Proxyman is installed
- install Proxyman on macOS, Windows, or Linux
- open Proxyman before configuring MCP
- locate the bundled MCP bridge executable
- prepare Proxyman for later traffic capture

## Example prompts
- Check for Proxyman on macOS, install it if needed, launch it, and prepare MCP.
- Install Proxyman on Windows with PowerShell, open it, and locate its MCP bridge.
- Download the Linux AppImage, launch Proxyman, and verify the MCP bridge path.

## Similar
- [firecrawl-download](https://affpapa.org/en/nevibecode/skills/firecrawl-download.md) — skill · 79900 installs
- [recipe-bulk-download-folder](https://affpapa.org/en/nevibecode/skills/recipe-bulk-download-folder.md) — skill · 30800 installs
- [export-download-debugging](https://affpapa.org/en/nevibecode/skills/export-download-debugging.md) — skill · 1800 installs
- [video-download](https://affpapa.org/en/nevibecode/skills/video-download.md) — skill · 1200 installs
- [jetson-download-bsp](https://affpapa.org/en/nevibecode/skills/jetson-download-bsp.md) — skill · 1100 installs
- [download-page-generator](https://affpapa.org/en/nevibecode/skills/download-page-generator.md) — skill · 1000 installs

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