otak-proxy
One-click proxy management for VSCode, Git, npm, and integrated terminals
Toggle your proxy settings with a single click. Zero configuration required.
Quick Start
Already have a system proxy?
- Install the extension
- Click the status bar → select Auto
- Done — the extension syncs with your system proxy automatically
Need to set a proxy manually?
- Install the extension
- Click the status bar → select Manual
- Enter your proxy URL (e.g.,
http://proxy.example.com:8080)
The extension configures Git, VSCode, npm proxy settings, and proxy environment variables for VSCode integrated terminals for you.
Features
- Three modes — Off, Manual, or Auto (syncs with system proxy)
- Status bar toggle — One click to switch between modes
- Auto-sync — Detects system/browser proxy changes in real-time
- Connection validation — Tests proxy connectivity before enabling
- Integrated terminal env — Sets HTTP(S)_PROXY for new VSCode terminals
- i18n — English and Japanese UI
Integrated Terminal Environment Variables
When proxy is enabled, otak-proxy injects the following variables into newly created VSCode integrated terminals:
HTTP_PROXY / HTTPS_PROXYhttp_proxy / https_proxy
Existing terminals keep their current environment; reopen a terminal if you want the new values to apply.
How It Works
Status Bar
Click the proxy indicator to cycle through modes:
Off → Manual → Auto → Off
Commands (Cmd/Ctrl + Shift + P)
| Command |
Description |
| Toggle Proxy |
Cycle through modes |
| Test Proxy |
Verify proxy connectivity |
| Import System Proxy |
Detect and import system proxy |
| Configure Manual |
Set a custom proxy URL |
Status Indicators
| Indicator |
State |
Proxy: Off |
Disabled |
Manual: http://... |
Using configured proxy |
Auto: http://... |
Synced with system proxy |
Auto (Fallback): http://... |
System unavailable, using manual |
Auto: OFF |
Waiting for proxy availability |
Configuration
{
"otakProxy.proxyUrl": "http://proxy.example.com:8080",
"otakProxy.pollingInterval": 30,
"otakProxy.enableFallback": true
}
| Setting |
Description |
Default |
proxyUrl |
Manual proxy URL |
— |
pollingInterval |
System proxy check interval (sec) |
30 |
enableFallback |
Fall back to manual when system unavailable |
true |
Requirements
- VSCode 1.9.0+
- Git (in PATH)
Troubleshooting
Proxy not working?
- Verify URL format includes protocol (
http:// or https://)
- Run "Test Proxy" to check connectivity
- Confirm Git is installed:
git --version
Auto mode not detecting changes?
- Verify system proxy is configured correctly
- Adjust
pollingInterval if needed
License
MIT
Report Issues · Source Code
