sparkle-vpn
by cwyhkyochen-a11y
Web & Frontend DevelopmentBrief
Control Sparkle VPN - start and stop VPN connections using Mihomo core directly.
Description
What This Skill Does
Controls Sparkle VPN programmatically using the Mihomo core. Supports starting and stopping the VPN, toggling system-wide proxy settings, querying status, and switching between nodes, all without touching the GUI.
Scripting VPN control through Mihomo directly lets you automate node switching and proxy toggling without depending on the Sparkle GUI being open.
When to Use It
- Switch to a Japan node before accessing region-locked content
- Start VPN without system proxy for app-specific routing
- Check which node is active and available before a call
- Stop VPN and disable system proxy in one command
- Source proxy env vars into a terminal session for CLI tools
Example Workflow
User asks: switch to the Singapore node and enable system proxy
- 1
Call sparkle_vpn_status to confirm VPN is running
- 2
Call sparkle_vpn_switch with node name '新加坡-SIN-01-VL'
- 3
Call sparkle_vpn_enable_proxy to apply system-wide proxy settings
- 4
Verify the active node changed via sparkle_vpn_status
System proxy enabled and routed through the Singapore node
Requirements
- Sparkle VPN installed with Mihomo core configured at ~/.config/sparkle/
Installation
clawhub install cwyhkyochen-a11y/sparkle-vpnRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.