Agent skill · software engineering · aradotso
microwarp-cloudflare-proxy
microwarp-cloudflare-proxy — an agent skill for coding agents.
Why this skill is useful
Provides specific Docker commands and configurations for setting up a lightweight Cloudflare WARP proxy that the AI wouldn't reliably generate on its own.
What it needs
Requires docker installed locally. About 5k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
yaml docker-compose.yml version: '3.8' services: microwarp: image: ghcr.io/ccbkkb/microwarp:latest containername: microwarp restart: always ports: "1080:1080" capadd: NETADMIN SYSMODULE sysctls: net.ipv4.conf.all.srcvalidmark=1 volumes: warp-data:/etc/wireguard volumes: warp-data: bash docker compose up -d docker compose logs -f # watch first-run registration bash docker run -d \ --name microwarp \ --restart always \ -p 1080:1080 \ --cap-add NETADMIN \ --cap-add SYSMODULE \ --sysctl net.ipv4.conf.all.srcvalidmark=1 \ -v warp-data:/etc/wireguard \ ghcr.io/ccbkkb/microwarp:latest yaml version: '3.8' services: microwarp: image: ghcr.io/ccbkkb/microwarp:latest containername: microwarp restart: always ports: "1080:1080" capadd: NETADMIN SYSMODULE sysctls: net.ipv4.conf.all.srcvalidmark=1 environment: SOCKSUSER=${WARPUSER} SOCKSPASS=${WARPPASS} volumes: warp-data:/etc/wireguard volumes: warp-data: yaml environment: BINDADDR=127.0.0.1 # localhost only BINDPORT=9050 SOCKSUSER=${WARPUSER} SOCKSPASS=${WARPPASS} yaml environment: ENDPOINTIP=162.159.193.10:2408 yaml ports: "127.0.0.1:1080:1080" # only accessible from host environment: BINDADDR=0.0.0.0 # container listens on all interfaces bash Basic connectivity test curl --socks5 127.0.0.1:1080 https://cloudflare.com/cdn-cgi/trace With authentication curl --socks5-hostname 127.0.0.1:1080 \ --proxy-user "${WARPUSER}:${WARPPASS}" \ https://cloudflare.com/cdn-cgi/trace Check your IP via WARP curl --socks5 127.0.0.1:1080 https://ipinfo.io/json python import requests proxies = { "http": "socks5://127.0.0.1:1080", "https": "socks5://127.0.0.1:1080", } With auth proxiesauth = { "http": "socks5://user:pass@127.0.0.1:1080", "https": "socks5://user:pass@127.0.0.1:1080", } resp = requests.get("https://ipinfo.io/json", proxies=proxies) print(resp.json()) javascript import { SocksProxyAgent } from 'socks-proxy-agent'; import fetch from 'node-fetch'; const agent = new SocksProxyAgent('socks5://127.0.0.1:1080'); // With auth: 'socks5://user: …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/microwarp-cloudflare-proxy