Clash Meta (Mihomo) desktop client — Wails · Go · React
Windows · macOS · Linux

Русский · 简体中文 · Changelog · Support

Sloth Clash is a GPL-3.0 GUI around Mihomo (Clash Meta). This repository ships the Wails desktop shell (apps/sloth-clash-desktop). The Windows system service / IPC layer lives in a separate project: sloth-clash-service-ipc (release artifacts are consumed by pnpm run prebuild).

• Profiles, proxies, rules, and merge / script-style config workflows in the UI
• Mihomo core integration (stable channel via prebuild)
• One-click Proxy / TUN traffic modes with a live connection-health status
• Visual + YAML rule editor, live connections monitor, and a diagnostics/advanced panel
• Signed, fail-closed in-app updates (Windows) with UAC-elevated installer hand-off
• Windows service installer bundle + sidecar layout compatible with Wails packaging
• Deep link scheme slothclash:// (see wails.json)

Home — connect, Rule/Global mode, Proxy/TUN traffic, live health & speed	Profiles — import & manage subscriptions, usage, auto-update
Proxies — selector / url-test groups with latency and search	Connections — live per-process traffic, matched rule, up/down
Rules — full routing table with type / policy filters	Edit rules — visual builder + Advanced (YAML), subscription read-only base
Advanced — diagnostics, connectivity probes, recovery tools	Settings — theme, language, connection, updates & diagnostics

Releases for this app: SlothClash releases (when published).
Service binaries used at build time: sloth-clash-service-ipc releases.

Prerequisites: Go 1.25+, Node 20+, pnpm, Wails v2 (go run github.com/wailsapp/wails/v2/cmd/wails@latest works without a global install).

pnpm install
pnpm run desktop:resources   # mihomo sidecar, geo DBs, Sloth service exes, Windows icon → build/
pnpm run wails:dev           # or: pnpm run wails:build

desktop:resources writes under apps/sloth-clash-desktop/build/ (ignored by git). On Windows, pnpm run icons:windows is included there and refreshes build/windows/icon.ico from build/appicon.png so installers / shortcuts pick up the right icon.

GitHub Actions: .github/workflows/desktop-artifacts.yml (Windows, Linux, macOS arm64 + Release) and .github/workflows/desktop-artifacts-darwin-amd64.yml (macOS Intel — same tag, adds zip to the same Release).

See CONTRIBUTING.md.

Sloth Clash is free and GPL-3.0. If it's useful to you, a crypto donation helps keep development and releases going. Thank you! 🦥

Double-check the network before sending — wrong-network transfers are unrecoverable.

• Basis (upstream GUI this work descends from): clash-verge-rev — Clash Verge Rev (Tauri); Sloth Clash reimplements the product direction with Wails + Go in this repo.
• Proxy core (Clash Meta): MetaCubeX/mihomo.
• Desktop shell: Wails — Go backend + web frontend in one binary.

Also: zzzgydi/clash-verge (original Clash Verge), and the wider Clash ecosystem.

GPL-3.0