Start Here Quickstart Agents & Automation Use Cases Interactive Mode Direct Mode Proxy Mode Compatibility 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: user@example.com
  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

Use the selected proxy with the commands in this shell. Other terminals and system processes keep their existing connections. See what shellroute proxies.

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