Start Here Quickstart Agents & Automation Use Cases Interactive Mode Direct Mode Proxy Mode Support

Interactive Mode

Run shellroute to open a proxied shell. Your aliases, PATH, and shell functions all work inside. Connect to a country with /connect, then use your terminal normally — every HTTP request routes through the proxy.

Log in

Interactive mode requires shellroute login. Enter your email, receive a 6-digit code, done. New accounts are created automatically — no separate registration. You only need to log in once.

terminal
$ shellroute login
  Email: [email protected]
  Enter code sent to your email: 847291
  ✓ Logged in successfully

Open the shell

terminal
$ shellroute

  shellroute

  /connect <country>  Connect and route traffic
  /countries          List available countries
  /ssh <user@host>    SSH through the proxy
  /help               All commands
  /exit               Quit

● shellroute · not connected · direct traffic
~ ❯

You're now in a real shell. Nothing is proxied yet — use /connect to start routing.

Slash commands

Command Description
/connect <country> [city] Connect to a country, optionally targeting a city
/disconnect Disconnect and show session summary
/rotate Get a new exit IP from a different provider
/status Show connection info (country, IP, health)
/balance Show credit balance and rates
/countries List available countries
/cities <country> List cities in a country
/iptype [type] Set or show IP type: residential, datacenter, or mix. Applies to this session only.
/sticky [on|off] Attempts to keep the same IP on reconnect. Applies to this session only.
/ssh <user@host> SSH through the proxy
/login Switch account (exits to login flow)
/logout Remove credentials and exit
/help Show all commands
/exit Quit shellroute

Dynamic prompt

The prompt updates to show your connection state:

terminal
● shellroute · not connected · direct traffic
~ ❯ /connect US
  Connecting to US (residential)...
  ✓ Connected to US (United States) — New IP: 203.0.113.42
● shellroute us · 203.0.113.42
~ ❯ curl https://httpbin.org/ip
{"origin": "203.0.113.42"}

  ⚠ Connection lost.
  ⟳ Reconnecting...
  ✓ Reconnected — New IP: 198.51.100.17
● shellroute us · 198.51.100.17
~ ❯

What goes through the proxy

All HTTP and HTTPS traffic from this shell goes through the proxy. This works because shellroute uses the standard proxy protocol that curl, Python, Node.js, Go, and most HTTP tools support natively.

Proxied automatically

curl, wget, Python (requests, urllib), Node.js (fetch, axios), Go http.Client, Ruby, Java — any tool that reads proxy env vars.

Not proxied

  • SSH — doesn't read proxy env vars. Use /ssh user@host instead of ssh user@host.
  • ping, DNS, raw TCP — proxy env vars only cover HTTP/HTTPS traffic.
  • System processes — your browser, other terminals, and background services are unaffected. Only this shell is proxied.
Shellroute is a developer proxy tool for HTTP/HTTPS traffic, not a system-wide VPN.

Exiting

/disconnect stops routing but keeps the shell open. /exit disconnects and quits. Press Ctrl+C twice to force exit (first press shows a hint).

Log out

shellroute logout removes credentials from this machine. Inside the shell, use /logout to remove credentials and exit, or /login to switch to a different account.

Quickstart Direct Mode