skills.rest
ipruning
ipruningCOMMUNITY
Explore all skills by this author →
𝕏@ipruningGitHub

surge-cli

Diagnose and toggle Surge proxy states via CLI and HTTP API.

2|Updated Jan 18, 2026
Search Tags:#api#macos#diagnostics#network#proxy#surge#toggle
One-click install
npx skills add https://github.com/ipruning/skills --skill surge-cli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: surge-cli
Source: https://github.com/ipruning/skills/tree/main/surge-cli
Command: npx skills add https://github.com/ipruning/skills --skill surge-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users relying on Surge for network proxying in restricted environments often face difficulty diagnosing whether proxies (shell env vars) or Surge's Enhanced Mode are misconfigured, causing global or per-application traffic to hang.

Core Features & Use Cases

  • Diagnose network health and proxy states using Surge CLI such as surge diagnostics, surge environment, and surge dump commands.
  • Toggle Surge Enhanced Mode and system proxy settings via HTTP API and CLI to recover connectivity in restricted networks.
  • Use case: in a China-based macOS setup with Surge, quickly identify whether outbound mode is correct and restore direct or proxy routing without reinstalling software.

Quick Start

Run surge diagnostics to assess the current network health and determine whether outbound or enhanced mode needs adjustment.

Frequently Asked Questions about surge-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose Surge proxy issues on macOS when network traffic hangs?▼

Run `surge diagnostics` to assess network health and identify whether shell environment variables or Surge Enhanced Mode are misconfigured, causing traffic to hang on macOS.

How do I toggle Surge Enhanced Mode to restore network connectivity on macOS?▼

Toggle Surge Enhanced Mode and system proxy settings via the Surge HTTP API and CLI to switch between direct and proxy routing, recovering macOS connectivity in restricted networks.

Why does my macOS application traffic hang when using Surge in China?▼

Application traffic hangs when Surge shell environment variables or system-wide Enhanced Mode are misconfigured. Run `surge environment` to inspect proxy states and correct outbound routing.

Can I use Surge CLI to fix SSL/TLS proxy issues on macOS?▼

Yes, Surge CLI diagnoses SSL/TLS proxy issues on macOS by running `surge dump` to inspect local configuration files and HTTP API endpoints to read and modify proxy states.

What's the best way to verify proxy states and outbound mode in Surge?▼

Run `surge diagnostics` and `surge environment` commands to verify proxy states and outbound mode, checking system proxy settings and Enhanced Mode interactions to confirm correct routing.

Does diagnosing Surge Enhanced Mode require access to local configuration files?▼

Yes, diagnosing Surge Enhanced Mode requires access to Surge CLI, HTTP API endpoints, and local configuration files to read and modify system-wide proxy states and recover connectivity.

Related Skills

Explore More Software Engineering Skills→
flavien-iaflavien-ia
34

_setup-stripe-cli

Install and authenticate the Stripe CLI across Windows, macOS, and Linux.

Community
Intermediate
fukukei23fukukei23

proxy-doctor

Diagnose Claude Code CLI local proxy failures affecting GLM and MiniMax routing.

Community
Advanced
Andrejr82Andrejr82

bash-linux

Reference Bash commands and scripting patterns for Linux and macOS environments.

Community
Intermediate
darblexdarblex

dns-networking

Debug DNS resolution, network connectivity, and HTTP request failures.

Community
Intermediate