Repolode
AstraFoundry

AstraFoundry/KumoApp

Ненавязчивый десктопный клиент для прокси-ядра Mihomo на Go с интерфейсом на React и CLI, удобным для coding agents.

Звёзды
299
Форки
13
Открытые issues
5
Последний коммит
16 дней назад

Что это?

Kumo — десктопный клиент для управления прокси-ядром Mihomo. На первом экране видно, подключён ли Kumo, какой режим активен, включён ли системный прокси, а также какие профиль и узлы используются. Для DNS, TUN, правил, логов, переопределений и схемы маршрутизации предусмотрены отдельные страницы.

Приложение собрано в один бинарный файл Go с помощью MyGo; фронтенд на React использует coss ui. В приложении есть пункт в строке меню и уведомления. При выходе из Kumo или если процесс-страж обнаруживает сбой, Kumo останавливает ядро и отключает системный прокси, но только если эта настройка по-прежнему принадлежит Kumo. Если системный прокси переключается на другое приложение или порт уже занят, Kumo сообщает о конфликте, а не перезаписывает настройку.

Тот же исполняемый файл работает как CLI `kumo` с выводом `--json`, поддержкой пробного запуска и предсказуемыми кодами завершения. На страницах можно скопировать готовые промпты для coding agents, а для Claude Code, Codex, Cursor и Gemini CLI можно установить skill для Kumo.

Ключевые возможности

  • 01На обзорном экране отображаются состояние подключения, активный режим, статус системного прокси и текущий профиль.
  • 02Схема связывает входные узлы, правила, группы и узлы, выделяя неработающие ссылки.
  • 03При выходе или сбое восстанавливает системный прокси и останавливает ядро, только если они по-прежнему принадлежат Kumo.
  • 04Обнаруживает конфликты портов и изменения системного прокси другими приложениями и сообщает о них.
  • 05CLI со стабильными командами, выводом JSON, пробным запуском и предсказуемыми кодами завершения.

Сценарии использования

  • Управление прокси-профилями Mihomo и выбором узлов на macOS через интерфейс, который ощущается нативным.
  • Получение coding agent сведений о состоянии прокси или переключение узлов через вывод CLI в формате JSON.
  • Изучение маршрутизации прокси на схеме, чтобы находить неправильно настроенные правила или группы.

Быстрый старт

  1. 1

    Скачайте образ диска со страницы Releases и откройте Kumo

  2. 2

    Установите зависимости из исходного кода

    bun install
  3. 3

    Запустите приложение с горячей перезагрузкой

    make dev

Что важно знать

  • Согласно значку, это десктопный клиент для macOS 13 и новее; для сборки из исходного кода в Linux требуется WebKitGTK.
  • Проект активно разрабатывается, поэтому его поведение и интерфейсы могут меняться.
  • Лицензия AGPL-3.0 требует раскрывать исходный код модификаций, доступных по сети.

В подборках

Темы

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

Частые вопросы

Что такое KumoApp?
Ненавязчивый десктопный клиент для прокси-ядра Mihomo на Go с интерфейсом на React и CLI, удобным для coding agents. Kumo — десктопный клиент для управления прокси-ядром Mihomo. На первом экране видно, подключён ли Kumo, какой режим активен, включён ли системный прокси, а также какие профиль и узлы используются. Для DNS, TUN, правил, логов, переопределений и схемы маршрутизации предусмотрены отдельные страницы.
KumoApp можно использовать бесплатно? Какая у него лицензия?
KumoApp распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
KumoApp всё ещё поддерживается?
Активно поддерживается. Последний коммит в KumoApp — 22 окт. 2026 г..
Для чего можно использовать KumoApp?
Управление прокси-профилями Mihomo и выбором узлов на macOS через интерфейс, который ощущается нативным. Получение coding agent сведений о состоянии прокси или переключение узлов через вывод CLI в формате JSON. Изучение маршрутизации прокси на схеме, чтобы находить неправильно настроенные правила или группы.
Как установить KumoApp?
Скачайте образ диска со страницы Releases и откройте Kumo Установите зависимости из исходного кода: bun install Запустите приложение с горячей перезагрузкой: make dev
Где скачать KumoApp?
Исходный код и инструкции по установке — на GitHub: https://github.com/AstraFoundry/KumoApp

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Shell-скрипты для запуска прокси-ядер Clash / Mihomo в Linux: подписки, выбор узлов, Tun mode и встроенная команда doctor.

6,3 тыс.+25 за неделю1,2 тыс.ShellMITАктивно поддерживаетсяОбновлён в прошлом месяце

Плагин для LuCI, который запускает прокси-клиент Mihomo (Clash Meta) на роутерах OpenWrt и поддерживает маршрутизацию трафика по правилам и прозрачное проксирование.

28,1 тыс.+45 за неделю4,1 тыс.JavaScriptMITАктивно поддерживаетсяОбновлён 23 часа назад

Приложение-шлюз для macOS превращает Mac в прозрачный прокси в стиле Surge с маршрутизацией по устройствам, DHCP/DNS через dnsmasq и mihomo в роли прокси-движка.

2,6 тыс.+5 за неделю184GoGPL-3.0Обновлён 3 дня назад