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)

1. Install the extension.
2. Click the status bar and select Auto.
3. otak-proxy applies the system proxy to VS Code, Git, npm, and new integrated terminals.

Manual Mode

1. Install the extension.
2. Click the status bar and select Manual.
3. 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.
• Automatic connection testing — In Auto mode, periodically verifies that the active proxy is still reachable.
• Multi-instance sync — Shares proxy settings across all open VS Code/Cursor windows so they stay in step.
• 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 — 16 languages covering all G20 countries: English, Japanese, Chinese (Simplified), Chinese (Traditional, Taiwan), Korean, Vietnamese, Spanish, Portuguese (Brazil), French, German, Hindi, Indonesian, Italian, Russian, Arabic, and Turkish.

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 disabled
• Manual: http://... — Using the configured manual proxy
• Auto: http://... — Synced with the system proxy
• Auto (Fallback): http://... — The system proxy is unavailable; using the manual proxy
• Auto: 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_PROXY
• http_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,
  "otakProxy.autoTestEnabled": true,
  "otakProxy.testInterval": 60,
  "otakProxy.syncEnabled": true,
  "otakProxy.syncInterval": 1000,
  "otakProxy.detectionSourcePriority": ["environment", "vscode", "platform"],
  "otakProxy.maxRetries": 3
}

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.
• otakProxy.autoTestEnabled: Periodically test proxy connectivity in Auto mode (default: true)
• otakProxy.testInterval: Automatic connection test interval, in seconds (Auto mode only; range 30–600, default: 60)
• otakProxy.syncEnabled: Synchronize proxy settings across multiple VS Code/Cursor instances (default: true)
• otakProxy.syncInterval: Sync check interval, in milliseconds (range 100–5000, default: 1000)
• otakProxy.detectionSourcePriority: Order in which proxy detection sources are tried (default: ["environment", "vscode", "platform"])
• otakProxy.maxRetries: Maximum retries for proxy detection when it fails (default: 3)

Commands

Access via the Command Palette (Cmd/Ctrl+Shift+P):

• otak: Toggle Proxy
• otak: Test Proxy
• otak: Import System Proxy
• otak: Configure Manual Proxy
• otak: Toggle Proxy URL Visibility

Requirements

• VS Code 1.97.0 or higher
• Git available on PATH

Installation

1. Install from the VS Code Marketplace.
2. 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.

Related Extensions

• otak-monitor — Real-time system monitoring in VS Code.
• otak-committer — AI-assisted commit messages, pull requests, and issues.
• otak-restart — Quick reload shortcuts.
• otak-clock — Dual time zone clock for VS Code.
• otak-pomodoro — Pomodoro timer in VS Code.
• otak-zen — Minimal, distraction-free VS Code UI.

License

MIT License. See the LICENSE file for details.

Links

• VS Code Marketplace
• GitHub
• Issues