Repolode
Enviar
AstraFoundry

AstraFoundry/KumoApp

Um cliente desktop prático para o core de proxy Mihomo, feito com Go, interface React e uma CLI pronta para agentes.

Ver no GitHubSite
Estrelas
299
Forks
13
Issues abertas
5
Último commit
há 16 dias

O que é?

Kumo é um cliente desktop para gerenciar o core de proxy Mihomo. A tela inicial mostra se o Kumo está conectado, qual modo está ativo, se o proxy do sistema está ligado e quais perfil e nós estão em uso. DNS, TUN, regras, logs, overrides e uma visualização da topologia de roteamento ficam disponíveis em páginas separadas.

O app é um binário Go único, criado com MyGo, com frontend React usando coss ui. Ele inclui um item na barra de menus e notificações. Quando o Kumo é encerrado, ou quando o processo guardião detecta uma falha, ele para o core e limpa o proxy do sistema, mas somente se o Kumo ainda controlar essa configuração. Se outro app assumir o controle do proxy do sistema ou uma porta já estiver em uso, o Kumo informa o conflito em vez de sobrescrever a configuração.

O mesmo executável funciona como CLI `kumo`, com saída `--json`, suporte a dry-run e códigos de saída previsíveis. As páginas permitem copiar prompts prontos para agentes de programação, e é possível instalar uma skill do Kumo para Claude Code, Codex, Cursor e Gemini CLI.

Recursos principais

  • 01Tela de visão geral com o estado da conexão, o modo ativo, o status do proxy do sistema e o perfil atual.
  • 02Canvas de topologia que conecta entrada, regras, grupos e nós, destacando referências inválidas.
  • 03Restaura o proxy do sistema e para o core ao encerrar ou após uma falha, somente se o Kumo ainda os controlar.
  • 04Detecta conflitos de porta e alterações no proxy do sistema feitas por outros apps, e informa os problemas.
  • 05CLI com comandos estáveis, saída JSON, dry-run e códigos de saída previsíveis.

Casos de uso

  • Gerenciar perfis de proxy Mihomo e selecionar nós no macOS com uma interface de aparência nativa.
  • Permitir que um agente de programação consulte o status do proxy ou troque de nó usando a saída JSON da CLI.
  • Inspecionar o roteamento do proxy pela visualização da topologia para encontrar regras ou grupos configurados incorretamente.

Início rápido

  1. 1

    Baixe a imagem de disco na página Releases e abra o Kumo

  2. 2

    Instale as dependências a partir do código-fonte

    bun install
  3. 3

    Inicie o app com recarregamento ao vivo

    make dev

Antes de usar

  • De acordo com o selo, é um cliente para desktop destinado ao macOS 13 ou posterior; compilações a partir do código-fonte no Linux exigem WebKitGTK.
  • O projeto está em desenvolvimento ativo, então o comportamento e as interfaces podem mudar.
  • A licença AGPL-3.0 exige a divulgação do código-fonte de modificações disponibilizadas pela rede.

Em coleções

Ferramentas de CLI e terminalApps open source para MacAplicativos GUI para desktop e frameworks

Tópicos

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

Perguntas frequentes

O que é KumoApp?
Um cliente desktop prático para o core de proxy Mihomo, feito com Go, interface React e uma CLI pronta para agentes. Kumo é um cliente desktop para gerenciar o core de proxy Mihomo. A tela inicial mostra se o Kumo está conectado, qual modo está ativo, se o proxy do sistema está ligado e quais perfil e nós estão em uso. DNS, TUN, regras, logs, overrides e uma visualização da topologia de roteamento ficam disponíveis em páginas separadas.
KumoApp é gratuito? Qual é a licença?
KumoApp é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
KumoApp ainda é mantido?
Manutenção ativa. O último commit de KumoApp foi em 22 de out. de 2026.
Para que posso usar KumoApp?
Gerenciar perfis de proxy Mihomo e selecionar nós no macOS com uma interface de aparência nativa. Permitir que um agente de programação consulte o status do proxy ou troque de nó usando a saída JSON da CLI. Inspecionar o roteamento do proxy pela visualização da topologia para encontrar regras ou grupos configurados incorretamente.
Como instalar KumoApp?
Baixe a imagem de disco na página Releases e abra o Kumo Instale as dependências a partir do código-fonte: bun install Inicie o app com recarregamento ao vivo: make dev
Onde consigo KumoApp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AstraFoundry/KumoApp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados