Proxying a Single App

socksy set is system-wide. When you only want one program behind the proxy, socksy run sets the standard *_proxy variables for that command and leaves your desktop on a direct connection:

socksy run curl https://api.ipify.org     # uses the relay that's already up
socksy run --profile work firefox         # ephemeral relay, just for this app

Without --profile it reuses the running relay, starting one from your last proxy if none is up (again, without touching the desktop proxy). With --profile it starts a throwaway relay on its own port, torn down when the command exits, so it never disturbs a system-wide relay other apps are using. That means you can run two different exits side by side.

The command's exit code is passed through, so socksy run composes in scripts.

Saved profiles

socksy save work 'user:pass@host:port'   # remember a proxy under a name
socksy use  work                         # apply it (no name = last used)
socksy list                              # list saved proxies (passwords masked)
socksy rm   work                         # forget a saved proxy