stvlynn

stvlynn / KumoApp

Public

A calm, native macOS client for the Mihomo proxy core, built with SwiftUI and a shared agent-friendly CLI.

agent-friendly clash clash-meta cli liquid-glass
23
0
100% credibility
Found May 10, 2026 at 23 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Kumo is a native macOS app for easily managing Mihomo proxy profiles, connections, and system-wide proxy settings.

How It Works

1
🔍 Discover Kumo

You hear about Kumo, a simple Mac app that makes managing internet connections easy and calm.

2
📥 Get the app

Download Kumo from its page and open it on your Mac – it feels just like any other app.

3
➕ Add a connection profile

Paste a link to your proxy service or pick a file, and Kumo brings in your settings.

4
🚀 Start connecting

Click the big button to launch your secure connection – watch it light up green in seconds.

5
🔀 Pick your proxy

Choose from your list of connections and switch modes like Rule or Global with a tap.

6
🌐 Protect your whole Mac

Turn on system proxy so all your apps use the secure path without extra setup.

✅ Secure and simple

Now browse freely with peace of mind – Kumo runs quietly in the menu bar, ready anytime.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 23 to 23 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is KumoApp?

KumoApp is a calm, native macOS client for the Mihomo proxy core, built with SwiftUI for a distraction-free interface that prioritizes daily essentials like connection status, profile switching, and proxy selection. It pairs a menu bar app with an agent-friendly CLI that shares the same control layer, letting you manage proxies via commands like `kumo start`, `kumo select "Proxy" "HK-01"`, or `kumo status --json`. Solves the chaos of bloated proxy dashboards by keeping advanced tweaks (DNS, TUN, overrides) tucked away.

Why is it gaining traction?

Stands out with its serene SwiftUI design—think NavigationSplitView sidebar grouped by usage frequency—and seamless macOS integration like global shortcuts (Cmd+1 for rule mode), Spotlight search for profiles, and system proxy toggles. The CLI's predictable JSON output and dry-run flags make it scriptable for automation, unlike clunky web UIs or verbose alternatives. Early adopters praise the focused overview that answers "Am I connected?" at a glance.

Who should use this?

macOS devs or remote workers juggling VPNs/proxies who want a lightweight Mihomo frontend without Electron bloat. Ideal for teams scripting proxy switches in CI/CD or daily drivers needing quick profile imports from subscriptions. Skip if you're not on Sequoia+ or prefer full Clash Meta dashboards.

Verdict

Solid start for calm native proxy management on macOS—comprehensive docs, solid tests, active development—but at 23 stars and 1.0% credibility, it's pre-1.0; expect polish. Grab it if Mihomo's your core; watch for service mode in the roadmap.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.