Route internet traffic through a GitHub Codespace using sshuttle, with an optional reverse SSH tunnel so the Codespace can reach local or private networks.
Available as a CLI extension for gh and as a standalone desktop app.
Note
Replaces the no-longer-maintained GH CLI extension for remote resource access.
Cross-platform Electron app (Linux, macOS) with a one-click connect/disconnect flow. Pick or create a Codespace, press play, and the app handles everything: authentication, codespace startup, sshuttle routing, and tunnel validation.
- Frosted glass UI with five color themes and adjustable opacity
- Canvas-rendered dot-matrix status display
- Tabbed settings window (Connection, Routing, Appearance, System)
cd app && npm install && npm startnpm run dist # Linux AppImage + deb
npm run dist:mac # macOS dmgchmod +x CS-Proxy-*.AppImage
./CS-Proxy-*.AppImageSelf-contained, no install needed. Settings are stored in ~/.config/CS-Proxy/. The host still needs gh, sshuttle, and ssh (the app can auto-install missing tools from Settings > System).
See app/README.md for routing details, firewall authorization, and security notes.
gh extension install appatalks/cs-proxy
chmod +x ~/.local/share/gh/extensions/cs-proxy/cs-proxygh cs-proxy connect <codespace-name> [flags]| Flag | Description |
|---|---|
--all |
Route all traffic (0.0.0.0/0) |
--only-443 |
Route HTTPS/TLS only (0.0.0.0/0:443) |
--dns |
Tunnel DNS queries |
--domains "..." |
Route specific domains (space-separated) |
--gateway |
Reverse SSH tunnel to your localhost (default local:8000, remote:9000) |
Route TLS + DNS:
gh cs-proxy connect my-codespace --only-443 --dnsRoute specific domains with a local gateway:
gh cs-proxy connect my-codespace --domains "github.com api.github.com" --gatewayRoute all traffic:
gh cs-proxy connect my-codespace --allCustom port mapping:
export LOCAL_PORT=3000 REMOTE_PORT=9001
gh cs-proxy connect my-codespace --gateway