Skip to content

Quick Start

Get cs-proxy running in under a minute.

Prerequisites

  • Python 3.8+
  • GitHub CLI (gh) installed and authenticated
  • ssh and curl available

Install

git clone https://github.com/dstours/fluffy-barnacle.git
cd fluffy-barnacle
pip install -e .

Authenticate

gh auth login

Start a Proxy

cs-proxy start

This will:

  1. Select an existing Codespace (or create one interactively)
  2. Start an SSH tunnel with SOCKS5 forwarding on 127.0.0.1:1080
  3. Run in the background with automatic reconnection

Verify

cs-tools ipcheck

This compares your direct IP with the proxied IP to confirm traffic is routing through the Codespace.

Use It

Route tools through the proxy

cs-tools pcurl https://ifconfig.me
cs-tools pnmap -p 80,443 target.com
cs-tools pffuf -u https://target.com/FUZZ -w wordlist.txt

Serve files publicly

cs-serve file payload.bin
# Gives you a public https://*.app.github.dev URL

Set up a VPN tunnel

sudo cs-wg up
sudo cs-wg route add 10.0.0.0/8

Two Proxies, Different Exit IPs

cs-proxy -n 2 start -l WestEurope -l EastUs
# Tunnel 1: socks5://127.0.0.1:1080  (WestEurope)
# Tunnel 2: socks5://127.0.0.1:1081  (EastUs)

curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me
curl --socks5-hostname 127.0.0.1:1081 https://ifconfig.me
cs-proxy status     # health + exit IP per tunnel
cs-proxy ssh        # numbered menu to pick which codespace to shell into

Stop

cs-proxy stop          # stop all proxy tunnels
cs-proxy down          # stop tunnels + shut down all managed codespaces
cs-proxy delete        # permanently delete codespace(s)

Next Steps