Skip to content
TakoAPI
Back to skills

sparkle-vpn

by cwyhkyochen-a11y

Web & Frontend Development
453Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User asks: switch to the Singapore node and enable system proxy

AGENT
  1. 1

    Call sparkle_vpn_status to confirm VPN is running

  2. 2

    Call sparkle_vpn_switch with node name '新加坡-SIN-01-VL'

  3. 3

    Call sparkle_vpn_enable_proxy to apply system-wide proxy settings

  4. 4

    Verify the active node changed via sparkle_vpn_status

OUTPUT

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-vpn

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links