---

name: sparkle-vpn description: Control Sparkle VPN - start, stop, manage system proxy, query status and switch nodes using Mihomo core directly.

Sparkle VPN Control

This skill provides tools to control the Sparkle VPN using Mihomo core directly (no GUI interaction needed).

Tools

VPN Control

• sparkle_vpn_start - Start VPN core only (port 7890 available, no system proxy)
• sparkle_vpn_start_with_proxy - Start VPN and enable system-wide proxy
• sparkle_vpn_stop - Stop VPN and disable system proxy

System Proxy Management

• sparkle_vpn_enable_proxy - Enable system-wide proxy settings (VPN must be running)
• sparkle_vpn_disable_proxy - Disable system-wide proxy settings

Node Management

• sparkle_vpn_status - Query current VPN status, active node and available nodes list
• sparkle_vpn_switch - Switch to a different VPN node

Implementation

Uses Mihomo core directly:

• Profile: ~/.config/sparkle/profiles/19c48c94cbb.yaml
• Proxy port: 7890 (HTTP/HTTPS)
• Config dir: ~/.config/sparkle/
• API port: 9090

Usage Examples

Start VPN with system proxy:

sparkle_vpn_start_with_proxy

Start VPN without system proxy (manual mode):

sparkle_vpn_start

Enable system proxy (after VPN is running):

sparkle_vpn_enable_proxy

Stop VPN:

sparkle_vpn_stop

Query status:

sparkle_vpn_status

Switch node:

sparkle_vpn_switch "香港-HKG-01-VL"

Common Nodes

• 自动选择 - Auto select best node
• 故障转移 - Fallback mode
• 香港-HKG-01-VL - Hong Kong node
• 香港-HKG-02-VL - Hong Kong node 2
• 香港-HKT-01-VL - Hong Kong HKT
• 新加坡-SIN-01-VL - Singapore node
• 日本-TYO-01-VL - Japan Tokyo node
• 美国-SJC-01-VL - US San Jose node

System Proxy Support

System proxy settings are applied via:

• GNOME gsettings (for GNOME/GTK desktops)
• Environment variables saved to ~/.config/sparkle/proxy.env

To use proxy in current terminal session:

source ~/.config/sparkle/proxy.env