explaingit

zzzgydi/clash-verge

Analysis updated 2026-06-21

22,046TypeScriptAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

Clash Verge is a desktop app for Windows, macOS, and Linux that wraps the Clash network proxy tool in a visual interface, letting you manage proxy profiles and route internet traffic by rules without editing config files.

Mindmap

mindmap
  root((Clash Verge))
    What it does
      Proxy GUI
      Rule-based routing
      System proxy setter
    Features
      Profile management
      JS script customization
      Clash.Meta built-in
    Platforms
      Windows
      macOS
      Linux
    Tech
      Tauri framework
      TypeScript UI
      Rust backend
    Audience
      Privacy-conscious users
      Power users
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Switch between different proxy server profiles on your desktop without manually editing YAML configuration files.

USE CASE 2

Set your system proxy automatically so all applications route through your chosen server without per-app configuration.

USE CASE 3

Customize proxy rules using JavaScript scripts to control which sites route through which server.

What is it built with?

TypeScriptRustTauri

How does it compare?

zzzgydi/clash-vergeactivepieces/activepiecesqwikdev/qwik
Stars22,04622,07122,000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/53/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Clash-compatible proxy subscription or configuration file to be useful after installation.

GPL-3.0, free to use and modify, but any distributed version must also be released as open source under the same license.

In plain English

Clash Verge is a desktop application that provides a visual interface for Clash, a rule-based network proxy tool. A proxy tool routes your internet traffic through a server or set of servers, Clash in particular does this based on rules you configure (for example, route traffic to certain sites through a specific server while letting other traffic go directly). Clash Verge makes it easier to use Clash by wrapping it in a graphical window instead of requiring you to work with configuration files directly. Key features include managing multiple proxy configuration "profiles" (you can store and switch between different sets of rules), customizing those profiles using YAML configuration files or JavaScript scripts, and a simple interface with customizable color themes. It also includes built-in support for the Clash.Meta core, an extended version of the Clash engine. The app can set your system-level proxy settings automatically, so applications across your computer route through your chosen proxy without extra configuration per app. Clash Verge runs on Windows, macOS (version 11 and above), and Linux. Installation packages are provided for each platform. The app is built using Tauri, a framework that wraps web-based UI code in a lightweight native desktop shell, with TypeScript for the interface and Rust for the underlying system code. It is released under the GPL-3.0 open-source license.

Copy-paste prompts

Prompt 1
I have a Clash proxy subscription URL. How do I import it into Clash Verge and activate it as my system proxy?
Prompt 2
How do I write a JavaScript script in Clash Verge to modify my proxy profile rules before they are applied?
Prompt 3
Set up Clash Verge on Linux to route all traffic through a specific proxy server while excluding local network addresses.

Frequently asked questions

What is clash-verge?

Clash Verge is a desktop app for Windows, macOS, and Linux that wraps the Clash network proxy tool in a visual interface, letting you manage proxy profiles and route internet traffic by rules without editing config files.

What language is clash-verge written in?

Mainly TypeScript. The stack also includes TypeScript, Rust, Tauri.

What license does clash-verge use?

GPL-3.0, free to use and modify, but any distributed version must also be released as open source under the same license.

How hard is clash-verge to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is clash-verge for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub zzzgydi on gitmyhub

Verify against the repo before relying on details.