Repolode
Enviar
AstraFoundry

AstraFoundry/KumoApp

Un cliente de escritorio sencillo para el núcleo de proxy Mihomo, creado con Go, una interfaz de React y una CLI pensada para agentes.

Ver en GitHubSitio web
Estrellas
297
Forks
13
Issues abiertos
5
Último commit
hace 15 días

¿Qué es?

Kumo es un cliente de escritorio para gestionar el núcleo de proxy Mihomo. La pantalla inicial muestra si Kumo está conectado, qué modo está activo, si el proxy del sistema está habilitado y qué perfil y nodos se están usando. DNS, TUN, reglas, registros, overrides y una vista de la topología de enrutamiento están disponibles en páginas separadas.

La aplicación es un único binario de Go creado con MyGo y cuenta con un frontend de React que usa coss ui. Incluye un elemento en la barra de menús y notificaciones. Al salir de Kumo o si su proceso guardian detecta un fallo, detiene el núcleo y desactiva el proxy del sistema, pero solo si Kumo sigue controlando esa configuración. Si otra aplicación toma el control del proxy del sistema o un puerto ya está en uso, Kumo informa del conflicto en lugar de sobrescribir la configuración.

El mismo ejecutable funciona como la CLI `kumo`, con salida `--json`, compatibilidad con ejecuciones de prueba y códigos de salida predecibles. Las páginas permiten copiar prompts listos para agentes de programación, y se puede instalar una skill de Kumo para Claude Code, Codex, Cursor y Gemini CLI.

Funciones clave

  • 01Pantalla general que muestra el estado de conexión, el modo activo, el estado del proxy del sistema y el perfil actual.
  • 02Lienzo de topología que conecta la entrada, las reglas, los grupos y los nodos, y destaca las referencias rotas.
  • 03Restaura el proxy del sistema y detiene el núcleo al salir o si se produce un fallo, solo si Kumo sigue controlándolos.
  • 04Detecta conflictos de puertos y cambios en el proxy del sistema realizados por otras aplicaciones, e informa de ellos.
  • 05CLI con comandos estables, salida JSON, modo de prueba y códigos de salida predecibles.

Casos de uso

  • Gestionar perfiles de proxy Mihomo y seleccionar nodos en macOS mediante una interfaz con aspecto nativo.
  • Permitir que un agente de programación consulte el estado del proxy o cambie de nodo mediante la salida JSON de la CLI.
  • Inspeccionar el enrutamiento del proxy con la vista de topología para encontrar reglas o grupos mal configurados.

Inicio rápido

  1. 1

    Descarga la imagen de disco desde la página de Releases y abre Kumo

  2. 2

    Instala las dependencias desde el código fuente

    bun install
  3. 3

    Inicia la aplicación con recarga en vivo

    make dev

Antes de usarlo

  • Según la insignia, es un cliente de escritorio para macOS 13 o posterior; para compilar desde el código fuente en Linux se necesita WebKitGTK.
  • El proyecto está en desarrollo activo, por lo que el comportamiento y las interfaces pueden cambiar.
  • La licencia AGPL-3.0 exige publicar el código fuente de las modificaciones disponibles a través de una red.

En colecciones

Herramientas de CLI y terminalApps open source para MacAplicaciones GUI de escritorio y frameworks

Temas

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

Preguntas frecuentes

¿Qué es KumoApp?
Un cliente de escritorio sencillo para el núcleo de proxy Mihomo, creado con Go, una interfaz de React y una CLI pensada para agentes. Kumo es un cliente de escritorio para gestionar el núcleo de proxy Mihomo. La pantalla inicial muestra si Kumo está conectado, qué modo está activo, si el proxy del sistema está habilitado y qué perfil y nodos se están usando. DNS, TUN, reglas, registros, overrides y una vista de la topología de enrutamiento están disponibles en páginas separadas.
¿KumoApp es gratuito? ¿Qué licencia tiene?
KumoApp es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿KumoApp sigue mantenido?
Mantenimiento activo. El último commit de KumoApp fue el 22 oct 2026.
¿Para qué puedo usar KumoApp?
Gestionar perfiles de proxy Mihomo y seleccionar nodos en macOS mediante una interfaz con aspecto nativo. Permitir que un agente de programación consulte el estado del proxy o cambie de nodo mediante la salida JSON de la CLI. Inspeccionar el enrutamiento del proxy con la vista de topología para encontrar reglas o grupos mal configurados.
¿Cómo se instala KumoApp?
Descarga la imagen de disco desde la página de Releases y abre Kumo Instala las dependencias desde el código fuente: bun install Inicia la aplicación con recarga en vivo: make dev
¿Dónde consigo KumoApp?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/AstraFoundry/KumoApp

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados