Changelog

New features, improvements, and fixes to the Shellroute CLI.

0.2.1

Literal proxy credentials

  • ~ Credentials taken as written — a proxy password with /, #, ?, %, spaces or @ no longer needs percent-encoding. Entries saved by 0.2.0 keep working.
  • ~ Actionable errors — when a proxy rejects the login, or the shell splits an unquoted URL, the error says what to do about it.
0.2.0

Bring your own proxy

  • + Own proxies — save a proxy with shellroute upstream add, use it with shellroute run <name> or /connect <name> in the interactive shell. HTTP, HTTPS, SOCKS5 and SOCKS5H supported.
  • + No-save forms — shellroute run --proxy <url> for one-off use, SHELLROUTE_PROXY env var for CI.
  • + No account needed — own proxies work without login. Nothing is metered or billed. Documentation.
0.1.6

API key from the environment works everywhere

  • ~ SHELLROUTE_API_KEY was ignored on machines that had never run shellroute login, so CI runners and containers reported "Not authenticated". The variable is now read whether or not a config file exists.
  • ~ shellroute run no longer fails when the config directory cannot be created, for example in a container without a home directory. The session bookkeeping file is skipped instead.
0.1.5

Help text correction

  • ~ The /help list inside a session named a command that no longer exists. It now shows shellroute proxy --country for the persistent proxy.
  • ~ Clearer package descriptions on npm and Homebrew, and consistent spelling of the product name in messages and docs
0.1.4

Clean shutdown for scripts and servers

  • + Signal handling in direct mode — Ctrl+C, SIGTERM, and terminal close now reach the command run by shellroute run, and the session ends with its summary once the command stops. Suitable for systemd services.
  • + A command that ignores the stop signal is force-stopped after five seconds, or immediately on a second Ctrl+C
  • ~ shellroute run now exits with the command's exit code, or ends by the same signal the command did, so shells and systemd see the real result instead of status 255
  • ~ Interrupting shellroute run or shellroute proxy while still connecting now ends the session instead of leaving it open
0.1.3

Starter credit, logout fix

  • + Starter credit on signup — new accounts receive $1 credit automatically, shown after login
  • ~ Fixed /logout not working correctly in some configurations
  • ~ Low balance warning now triggers earlier so sessions don't fail unexpectedly
0.1.2

npm install fix

  • ~ Fixed npm install -g shellroute failing on some Node versions
0.1.1

Node.js support, compatibility matrix

  • + Node.js proxy support — Node's built-in fetch, http, and https modules now use the proxy automatically inside Shellroute sessions
  • + Compatibility matrix — tested results for curl, wget, Python, Node.js, Go, Playwright, and more. See what Shellroute proxies.
  • ~ Local traffic (localhost, 127.0.0.1) no longer routes through the proxy
0.1.0

Initial release

  • + Interactive mode — open a proxied shell with /connect, /rotate, /disconnect
  • + Direct mode — shellroute run US -- curl ... for scripts, CI, and agents
  • + Persistent proxy — shellroute proxy --country US for tools with explicit proxy URLs
  • + 120+ countries with residential and datacenter exits
  • + City targeting and sticky IPs for consistent sessions
  • + Kill switch — traffic fails instead of leaking when the tunnel drops
  • + Auto-reconnect on connection loss
  • + Pay per GB with real-time balance and usage tracking
  • + Email OTP login, API key support for CI, macOS and Linux