nova-client-proxy

Configure and operate the Nova Client Flutter VPN app built on the sing-box core.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill nova-client-proxy-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nova-client-proxy
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/nova-client-proxy
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill nova-client-proxy-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up and troubleshooting a multi-protocol VPN client across Android, iOS, Windows, macOS, and Linux involves complex configuration of subscriptions, routing rules, and clean-IP scanning that this Skill documents end to end. ## Core Features & Use Cases - Multi-Protocol Profile Setup: Add VLESS, VMess, Trojan, and Shadowsocks nodes via subscription URLs or manual JSON profiles with Reality/TLS settings. - Nova Radar Clean-IP Scanner: Scan Cloudflare IP ranges with TCP and TLS handshake tests to find low-latency clean IPs for CDN-based proxies. - Smart Routing & sing-box Integration: Generate sing-box configurations with rule-based routing, including .ir domain direct bypass and ad blocking. - Use Case: A user in Iran wants to connect through the fastest available node while keeping domestic sites direct; use this Skill to configure the subscription, scan clean IPs, test node latency, and apply the routing rules. ## Quick Start Help me set up Nova Client on my device, add a VLESS subscription, and configure routing so Iranian sites bypass the proxy.

Frequently Asked Questions about nova-client-proxy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a VLESS proxy profile to Nova Client?▼

Add a manual profile in profiles.json with protocol set to vless, including address, port, UUID, flow, network, and security fields. For Reality TLS, also provide the SNI, fingerprint, public key, and short ID.

How to scan Cloudflare clean IPs with Nova Radar?▼

Nova Radar fetches IP lists from sources like cloudflare.com/ips-v4, then runs TCP connectivity tests followed by TLS handshake latency measurement. Results are sorted by latency and the top IPs can be exported or used directly in proxy configs.

Does Nova Client support routing Iranian sites directly?▼

Yes, Nova Client supports rule-based routing with domain_suffix rules for .ir domains and geoip IR rules directed to a direct outbound. It also supports LAN bypass for private IP ranges and keyword-based ad blocking.

Which platforms does Nova Client VPN support?▼

Nova Client runs on Android, iOS, Windows, macOS, and Linux. Android uses APK installs, Windows offers an installer or portable ZIP, macOS uses a DMG, and Linux provides an AppImage or tarball.

Why does Nova Client fail to connect to a node?▼

Connection failures usually come from unreachable nodes, invalid configuration, or missing required fields like a VLESS UUID or Reality public key. Run a latency test to check node health and validate the profile fields before connecting.

How do I fix the VPN service not starting on Android?▼

The Android VPN service requires explicit user permission through the VpnService intent. Launch the android.net.VpnService intent for the app package to request authorization before starting the tunnel.