Repolode
Submit
AstraFoundry

AstraFoundry/KumoApp

A calm desktop client for the Mihomo proxy core, built with Go, a React UI and an agent-friendly CLI.

View on GitHubWebsite
Stars
299
Forks
13
Open issues
5
Last commit
16 days ago

What is it?

Kumo is a desktop client for managing the Mihomo proxy core. Its first screen shows whether Kumo is connected, which mode is active, whether the system proxy is on, and which profile and nodes are in use. DNS, TUN, rules, logs, overrides and a routing topology view are available on separate pages.

The app is a single Go binary built with MyGo, with a React frontend using coss ui. It includes a menu bar item and notifications. When Kumo quits, or when its guardian process catches a crash, it stops the core and clears the system proxy, but only if Kumo still owns that setting. If another app takes over the system proxy or a port is already in use, Kumo reports the conflict instead of overriding it.

The same executable works as the `kumo` CLI, with `--json` output, dry-run support and predictable exit codes. Pages can copy ready-made prompts for coding agents, and a Kumo skill can be installed for Claude Code, Codex, Cursor and Gemini CLI.

Key features

  • 01Overview screen showing connection state, active mode, system proxy status and current profile.
  • 02Topology canvas linking entry, rules, groups and nodes, with broken references highlighted.
  • 03Restores the system proxy and stops the core on quit or crash, only if Kumo still owns them.
  • 04Detects port conflicts and other apps changing the system proxy, and reports them.
  • 05CLI with stable commands, JSON output, dry-run and predictable exit codes.

Use cases

  • Managing Mihomo proxy profiles and node selection on macOS with a native-feeling interface.
  • Letting a coding agent query proxy status or switch nodes through the CLI's JSON output.
  • Inspecting proxy routing with the topology view to find misconfigured rules or groups.

Quick start

  1. 1

    Download the disk image from the Releases page and open Kumo

  2. 2

    Install dependencies from source

    bun install
  3. 3

    Start the app with live reload

    make dev

Things to know

  • Desktop client targeting macOS 13+ per the badge; Linux needs WebKitGTK for source builds.
  • Status is active development, so behavior and interfaces may change.
  • Licensed under AGPL-3.0, which requires source disclosure for networked modifications.

In collections

CLI & terminal toolsOpen-source Mac appsDesktop GUI apps & toolkits

Topics

#proxy#mihomo#clash#macos#desktop-app#cli#agent-friendly#go#clash-meta#liquid-glass

FAQ

What is KumoApp?
A calm desktop client for the Mihomo proxy core, built with Go, a React UI and an agent-friendly CLI. Kumo is a desktop client for managing the Mihomo proxy core. Its first screen shows whether Kumo is connected, which mode is active, whether the system proxy is on, and which profile and nodes are in use. DNS, TUN, rules, logs, overrides and a routing topology view are available on separate pages.
Is KumoApp free to use? What license does it have?
KumoApp is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is KumoApp still maintained?
Actively maintained. The last commit to KumoApp was on Oct 22, 2026.
What can I use KumoApp for?
Managing Mihomo proxy profiles and node selection on macOS with a native-feeling interface. Letting a coding agent query proxy status or switch nodes through the CLI's JSON output. Inspecting proxy routing with the topology view to find misconfigured rules or groups.
How do I install KumoApp?
Download the disk image from the Releases page and open Kumo Install dependencies from source: bun install Start the app with live reload: make dev
Where can I get KumoApp?
The source code and installation instructions are on GitHub: https://github.com/AstraFoundry/KumoApp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects