HomeBrowseUpload
← Back to registry
// Skill profile

Sparkle VPN Control

name: sparkle-vpn

by cwyhkyochen-a11y · published 2026-03-22

API集成
Total installs
0
Stars
★ 0
Last updated
2026-03
// Install command
$ claw add gh:cwyhkyochen-a11y/cwyhkyochen-a11y-sparkle-vpn
View on GitHub
// Full documentation

---

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
    // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band