otak-proxy
Proxy settings for VS Code, Git, npm, and integrated terminals.
Use the status bar to switch proxy modes. Auto mode follows your system proxy; Manual mode uses the proxy URL you enter.
Quick Start
Auto Mode (System Proxy)
- Install the extension.
- Click the status bar and select Auto.
- otak-proxy applies the system proxy to VS Code, Git, npm, and new integrated terminals.
Manual Mode
- Install the extension.
- Click the status bar and select Manual.
- Enter your proxy URL (for example:
http://proxy.example.com:8080).
In both modes, otak-proxy updates proxy settings for VS Code, Git, and npm. It also sets proxy environment variables for new VS Code integrated terminals.
Features
- Modes — Off, Manual, and Auto.
- Auto mode — Reads the system proxy and applies changes in the background.
- Manual mode — Uses the proxy URL you enter.
- Status bar control — Switch modes from the VS Code status bar.
- Connection test — Checks whether a proxy can be reached before enabling it.
- Integrated terminals — Sets
HTTP_PROXY and HTTPS_PROXY for new VS Code terminals.
- URL display setting — Hide the proxy URL in the status bar when needed.
- UI languages — English, Japanese, Chinese (Simplified), Chinese (Traditional, Taiwan), Korean, and Vietnamese.
UI language follows your VS Code display language.
How It Works
Status Bar
Click the proxy indicator to cycle through modes:
Off → Manual → Auto → Off
Status Indicators
Proxy: Off — Proxy is disabledManual: http://... — Using the configured manual proxyAuto: http://... — Synced with the system proxyAuto (Fallback): http://... — The system proxy is unavailable; using the manual proxyAuto: OFF — No proxy is currently available
When otakProxy.showProxyUrl is false, the URL is replaced with Configured (for example, Manual: Configured).
Integrated Terminal Environment
When proxy is enabled, otak-proxy sets these variables for newly created VS Code integrated terminals:
HTTP_PROXY / HTTPS_PROXYhttp_proxy / https_proxy
Existing terminals keep their current environment. Open a new terminal for the updated values to take effect.
Configuration
{
"otakProxy.proxyUrl": "http://proxy.example.com:8080",
"otakProxy.pollingInterval": 30,
"otakProxy.enableFallback": true,
"otakProxy.showProxyUrl": true
}
Settings
otakProxy.proxyUrl: Manual proxy URL (default: unset)otakProxy.pollingInterval: System proxy check interval, in seconds (default: 30)otakProxy.enableFallback: Fall back to the manual proxy when the system proxy is unavailable (default: true)otakProxy.showProxyUrl: Show the proxy URL in the status bar (default: true). Set this to false to display Configured instead of the actual URL.
Commands
Access via the Command Palette (Cmd/Ctrl+Shift+P):
otak: Toggle Proxyotak: Test Proxyotak: Import System Proxyotak: Toggle Proxy URL Visibility
Requirements
- VS Code 1.9.0 or higher
- Git available on PATH
Installation
- Install from the VS Code Marketplace.
- Click the status bar and choose Auto or Manual.
Security & Privacy
Local Configuration Changes
- Updates VS Code, Git, and npm proxy settings.
- Sets
HTTP_PROXY and HTTPS_PROXY environment variables for new integrated terminals.
Credentials
- No account or API key is required.
- If your proxy requires credentials, include them in the URL you provide.
- Passwords are masked when proxy URLs are shown in the UI or logs.
Network Activity
- otak-proxy checks whether the proxy is reachable before enabling it.
Troubleshooting
- Proxy not working: Make sure the URL starts with
http:// or https://, then run Test Proxy.
- Git not detected: Make sure Git is installed and available on PATH (
git --version).
- Auto mode does not detect changes: Check your system proxy settings and adjust
otakProxy.pollingInterval.
License
MIT License. See the LICENSE file for details.
Links
