How do I install the Astrill Control skill?

Run npx skillmds@latest add fudesign2008/astrill-control in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Astrill Control safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Astrill Control?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Astrill Control free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Astrill Control?

fudesign2008 (@fudesign2008) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Astrill Control by fudesign2008 — Agent Skill

Name: Astrill Control
Author: fudesign2008

Astrill Control

Control Astrill VPN on macOS through its menu-bar GUI: status (app / tunnel / GUI menu / exit IP), connect, disconnect — all idempotent, verified by dual probes (tunnel process + exit IP) plus GUI menu state. Use whenever the user mentions Astrill, asks to turn the VPN on or off, connect or disconnect the VPN, check VPN status or exit IP, or needs to switch VPN state around network-sensitive steps where one platform requires the proxy and another requires a direct connection. Prerequisite (one-time): the app hosting the agent holds the macOS Accessibility permission. Do NOT use for other VPN clients or general network debugging. Triggers — 「Astrill」「打开 VPN」「连接 VPN」「VPN 开」「VPN on」「断开 VPN」「关掉 VPN」「VPN 关」「VPN off」「查 VPN 状态」「VPN 状态」「切换 VPN」「VPN 出口 IP」 / Astrill, turn on VPN, connect VPN, disconnect VPN, turn off VPN, check VPN status, toggle VPN, VPN exit IP.

fudesign2008 1f41ba8 3 files · 10.7 KB Updated Sep 17, 2026

File contents

Astrill VPN Control (macOS Menu-Bar Toggle + Dual-Probe Verification)

The Astrill macOS app ships no official CLI. Its menu-bar item Menu → Toggle ON/OFF can be located and clicked via AppleScript (System Events), and the menu item text mirrors the connection state — that menu anchor is what this skill relies on. Field-tested 2026-08-28 on OpenVPN full-tunnel mode with an on↔off round-trip.

Usage

Run the bundled script from this skill's base directory (the directory containing this SKILL.md):

bash <skill-dir>/scripts/astrill.sh status   # inspect: app / tunnel / GUI menu / exit IP
bash <skill-dir>/scripts/astrill.sh on       # connect (idempotent: no-op when already connected)
bash <skill-dir>/scripts/astrill.sh off      # disconnect (idempotent: no-op when already disconnected; app stays alive)

Resolve <skill-dir> from the skill base directory announced at load time; when unavailable, ask the user for the installed skill path.

State Machine and Probes

Signal	How collected	Meaning
App process	`pgrep -x astrill`	prerequisite for GUI control; kept alive after `off` so `on` reconnects faster
VPN tunnel	`pgrep -x asovpnc`	primary judge under OpenVPN mode; teardown takes ~10 s (script polls through it)
GUI menu	System Events reads items of the `Menu` menu	`Toggle OFF` present = connected; `Toggle ON` present = disconnected
Exit IP	`curl --max-time 6 ipinfo.io/ip`	cross-check: connected → foreign node IP; disconnected → local direct IP

on and off are idempotent: each first reads the current state and returns success immediately when the desired state already holds.

One-Time Prerequisite: Accessibility Permission

The app that hosts the agent (terminal, IDE, or desktop app) must hold the macOS Accessibility permission: System Settings → Privacy & Security → Accessibility → add the host app. Without it the script reports GUI unreachable and the status output names the cause.

Known Boundaries

OpenVPN vs OpenWeb: probes are most accurate under OpenVPN (full tunnel). In OpenWeb (browser-only proxy) mode the asovpnc tunnel probe does not apply — the GUI menu text stays the primary judge, and the exit-IP probe (curl) may not reflect the browser proxy state.
Teardown latency: after Toggle OFF the tunnel process exits ~10 s later than the UI flips; the script's 30 s polling window covers it.
Toggle, not quit: quit app also disconnects but drops the GUI session; the script uses Toggle so the app keeps running and a later on reconnects without relaunching.
Menu drift after updates: macOS or Astrill major updates may rename menus. When Menu or Toggle ON/OFF disappears, re-probe with osascript -e 'tell application "System Events" to tell process "Astrill" to get name of every menu of menu bar 1' and update the script accordingly.
Bash pitfall when editing the script: after a $var, a CJK/full-width character makes bash merge the following UTF-8 bytes into the variable name (set -u then reports unbound variable). Always write ${var}.

---name: astrill-controldescription: Control Astrill VPN on macOS through its menu-bar GUI: status (app / tunnel / GUI menu / exit IP), connect, disconnect — all idempotent, verified by dual probes (tunnel process + exit IP) plus GUI menu state. Use whenever the user mentions Astrill, asks to turn the VPN on or off, connect or disconnect the VPN, check VPN status or exit IP, or needs to switch VPN state around network-sensitive steps where one platform requires the proxy and another requires a direct connection. Prerequisite (one-time): the app hosting the agent holds the macOS Accessibility permission. Do NOT use for other VPN clients or general network debugging. Triggers — 「Astrill」「打开 VPN」「连接 VPN」「VPN 开」「VPN on」「断开 VPN」「关掉 VPN」「VPN 关」「VPN off」「查 VPN 状态」「VPN 状态」「切换 VPN」「VPN 出口 IP」 / Astrill, turn on VPN, connect VPN, disconnect VPN, turn off VPN, check VPN status, toggle VPN, VPN exit IP.---# Astrill VPN Control (macOS Menu-Bar Toggle + Dual-Probe Verification)> The Astrill macOS app ships no official CLI. Its menu-bar item `Menu → Toggle ON/OFF` can be located and clicked via AppleScript (System Events), and the menu item text mirrors the connection state — that menu anchor is what this skill relies on. Field-tested 2026-08-28 on OpenVPN full-tunnel mode with an on↔off round-trip.## UsageRun the bundled script from this skill's base directory (the directory containing this SKILL.md):```bashbash <skill-dir>/scripts/astrill.sh status # inspect: app / tunnel / GUI menu / exit IPbash <skill-dir>/scripts/astrill.sh on # connect (idempotent: no-op when already connected)bash <skill-dir>/scripts/astrill.sh off # disconnect (idempotent: no-op when already disconnected; app stays alive)```Resolve `<skill-dir>` from the skill base directory announced at load time; when unavailable, ask the user for the installed skill path.## State Machine and Probes| Signal | How collected | Meaning ||---|---|---|| App process | `pgrep -x astrill` | prerequisite for GUI control; kept alive after `off` so `on` reconnects faster || VPN tunnel | `pgrep -x asovpnc` | primary judge under OpenVPN mode; teardown takes ~10 s (script polls through it) || GUI menu | System Events reads items of the `Menu` menu | `Toggle OFF` present = connected; `Toggle ON` present = disconnected || Exit IP | `curl --max-time 6 ipinfo.io/ip` | cross-check: connected → foreign node IP; disconnected → local direct IP |`on` and `off` are idempotent: each first reads the current state and returns success immediately when the desired state already holds.## One-Time Prerequisite: Accessibility PermissionThe app that hosts the agent (terminal, IDE, or desktop app) must hold the macOS Accessibility permission: System Settings → Privacy & Security → Accessibility → add the host app. Without it the script reports `GUI unreachable` and the status output names the cause.## Known Boundaries- **OpenVPN vs OpenWeb**: probes are most accurate under OpenVPN (full tunnel). In OpenWeb (browser-only proxy) mode the `asovpnc` tunnel probe does not apply — the GUI menu text stays the primary judge, and the exit-IP probe (curl) may not reflect the browser proxy state.- **Teardown latency**: after Toggle OFF the tunnel process exits ~10 s later than the UI flips; the script's 30 s polling window covers it.- **Toggle, not quit**: `quit app` also disconnects but drops the GUI session; the script uses Toggle so the app keeps running and a later `on` reconnects without relaunching.- **Menu drift after updates**: macOS or Astrill major updates may rename menus. When `Menu` or `Toggle ON/OFF` disappears, re-probe with `osascript -e 'tell application "System Events" to tell process "Astrill" to get name of every menu of menu bar 1'` and update the script accordingly.- **Bash pitfall when editing the script**: after a `$var`, a CJK/full-width character makes bash merge the following UTF-8 bytes into the variable name (`set -u` then reports unbound variable). Always write `${var}`.

Frequently asked questions