surge-cli
CommunityDiagnose Surge-based proxies on macOS in China.
Authoripruning
Version1.0.0
Installs0
System Documentation
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.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: surge-cli Download link: https://github.com/ipruning/skills/archive/main.zip#surge-cli Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.