Repolode
提交项目
AstraFoundry

AstraFoundry/KumoApp

面向 Mihomo 代理核心的简洁桌面客户端，提供图形界面与可供 Agent 调用的 CLI。

在 GitHub 查看官网
Star
299
Fork
13
未关闭 Issue
5
最近提交
16天前

这是什么？

Kumo 是一款用于管理 Mihomo 代理核心的桌面客户端。首屏直接显示连接状态、当前模式、系统代理是否开启，以及正在使用的配置和节点。DNS、TUN、规则、日志、覆写和路由拓扑等功能则放在独立页面中，需要时再进入。

应用由 Go 编写，通过 MyGo 打包为单个二进制文件，前端使用 React 与 coss ui，并提供菜单栏图标和通知。退出应用或守护进程捕获到崩溃时，Kumo 会停止代理核心并清除系统代理，但仅限于系统代理仍由 Kumo 持有的情况。若其他应用接管了系统代理，或端口被占用，Kumo 会提示冲突而不会强行覆盖。

同一个可执行文件也可作为 `kumo` 命令行工具使用，支持 `--json` 输出、dry-run 预览和可预期的退出码。各页面可一键复制给编程 Agent 使用的提示词，并可为 Claude Code、Codex、Cursor、Gemini CLI 安装 Kumo 技能。

核心功能

  • 01首屏展示连接状态、当前模式、系统代理状态与当前配置。
  • 02拓扑画布展示入口、规则、策略组与节点之间的关系，并高亮失效引用。
  • 03退出或崩溃时停止代理核心并清除系统代理，且仅处理 Kumo 自己设置的部分。
  • 04检测端口冲突及其他应用对系统代理的修改，并给出提示。
  • 05命令行工具支持稳定命令、JSON 输出、dry-run 与可预期的退出码。

适用场景

  • 在 macOS 上通过接近原生的界面管理 Mihomo 配置与节点选择。
  • 让编程 Agent 通过命令行的 JSON 输出查询代理状态或切换节点。
  • 借助拓扑视图排查规则或策略组配置错误。

快速上手

  1. 1

    从 Releases 页面下载磁盘映像并打开 Kumo

  2. 2

    从源码安装依赖

    bun install
  3. 3

    启动带热重载的应用

    make dev

使用前须知

  • 根据徽章，桌面客户端面向 macOS 13 及以上版本；从源码在 Linux 上构建需要 WebKitGTK。
  • 项目处于积极开发阶段，行为和接口可能发生变化。
  • 采用 AGPL-3.0 许可证，网络服务中的修改需要公开源代码。

收录于专题

命令行与终端工具开源 Mac 应用桌面图形界面应用与框架

标签

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

常见问题

KumoApp 是什么？
面向 Mihomo 代理核心的简洁桌面客户端，提供图形界面与可供 Agent 调用的 CLI。 Kumo 是一款用于管理 Mihomo 代理核心的桌面客户端。首屏直接显示连接状态、当前模式、系统代理是否开启，以及正在使用的配置和节点。DNS、TUN、规则、日志、覆写和路由拓扑等功能则放在独立页面中，需要时再进入。
KumoApp 可以免费使用吗？用的什么许可证？
KumoApp 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
KumoApp 还在维护吗？
活跃维护中。KumoApp 最近一次提交是在 2026年10月22日。
KumoApp 适合用来做什么？
在 macOS 上通过接近原生的界面管理 Mihomo 配置与节点选择。 让编程 Agent 通过命令行的 JSON 输出查询代理状态或切换节点。 借助拓扑视图排查规则或策略组配置错误。
KumoApp 怎么安装和运行？
从 Releases 页面下载磁盘映像并打开 Kumo 从源码安装依赖: bun install 启动带热重载的应用: make dev
在哪里获取 KumoApp？
源代码和安装说明在 GitHub 上：https://github.com/AstraFoundry/KumoApp

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目