AstraFoundry/KumoApp
Go、React UI、エージェントに使いやすいCLIを備えた、Mihomo proxy core向けの落ち着いたデスクトップクライアント。
- スター
- 299
- フォーク
- 13
- 未解決の Issue
- 5
- 最終コミット
- 16 日前
これは何?
Kumoは、Mihomo proxy coreを管理するデスクトップクライアントです。最初の画面では、Kumoの接続状態、現在のモード、システムプロキシの有効・無効、使用中のプロファイルとノードを確認できます。DNS、TUN、ルール、ログ、オーバーライド、ルーティングのトポロジービューは、それぞれ別のページから利用できます。
このアプリはMyGoでビルドされた単一のGoバイナリで、フロントエンドにはcoss uiを使ったReactを採用しています。メニューバー項目と通知も備えています。Kumoの終了時、または監視プロセスがクラッシュを検知したときは、コアを停止してシステムプロキシを解除します。ただし、Kumoが引き続きその設定を所有している場合に限ります。別のアプリがシステムプロキシを引き継いだ場合や、ポートがすでに使用中の場合は、設定を上書きせずに競合を通知します。
同じ実行ファイルを`kumo` CLIとしても利用でき、`--json`出力、dry-run、予測可能な終了コードに対応しています。各ページからコーディングエージェント向けのプロンプトをコピーでき、Claude Code、Codex、Cursor、Gemini CLI向けにKumo skillをインストールできます。
主な機能
- 01接続状態、現在のモード、システムプロキシの状態、使用中のプロファイルを表示する概要画面。
- 02入口、ルール、グループ、ノードを結び、参照切れを強調表示するトポロジーキャンバス。
- 03終了時またはクラッシュ時に、Kumoが引き続き所有している場合に限り、システムプロキシを解除してコアを停止。
- 04ポートの競合や、別のアプリによるシステムプロキシの変更を検知して通知。
- 05安定したコマンド、JSON出力、dry-run、予測可能な終了コードを備えたCLI。
ユースケース
- ネイティブアプリのような操作感のインターフェースで、macOS上のMihomoプロキシのプロファイルやノード選択を管理する。
- CLIのJSON出力を通じて、コーディングエージェントにプロキシの状態確認やノード切り替えを行わせる。
- トポロジービューでプロキシのルーティングを調べ、設定ミスのあるルールやグループを見つける。
クイックスタート
- 1
Releasesページからディスクイメージをダウンロードして、Kumoを開きます
- 2
ソースから依存関係をインストールします
bun install - 3
ライブリロードでアプリを起動します
make dev
使う前に知っておきたいこと
- バッジによるとmacOS 13以降を対象としたデスクトップクライアントです。ソースからビルドする場合、LinuxではWebKitGTKが必要です。
- 現在は活発に開発中のため、動作やインターフェースが変更される場合があります。
- AGPL-3.0ライセンスの下で提供されており、ネットワーク経由で利用できる改変版についてソースコードの開示が必要です。
収録されている特集
トピック
よくある質問
- KumoApp とは?
- Go、React UI、エージェントに使いやすいCLIを備えた、Mihomo proxy core向けの落ち着いたデスクトップクライアント。 Kumoは、Mihomo proxy coreを管理するデスクトップクライアントです。最初の画面では、Kumoの接続状態、現在のモード、システムプロキシの有効・無効、使用中のプロファイルとノードを確認できます。DNS、TUN、ルール、ログ、オーバーライド、ルーティングのトポロジービューは、それぞれ別のページから利用できます。
- KumoApp は無料で使えますか?ライセンスは?
- KumoApp は AGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- KumoApp は今もメンテナンスされていますか?
- 活発にメンテナンス中。KumoApp の最終コミットは 2026年10月22日 です。
- KumoApp は何に使えますか?
- ネイティブアプリのような操作感のインターフェースで、macOS上のMihomoプロキシのプロファイルやノード選択を管理する。 CLIのJSON出力を通じて、コーディングエージェントにプロキシの状態確認やノード切り替えを行わせる。 トポロジービューでプロキシのルーティングを調べ、設定ミスのあるルールやグループを見つける。
- KumoApp のインストール方法は?
- Releasesページからディスクイメージをダウンロードして、Kumoを開きます ソースから依存関係をインストールします: bun install ライブリロードでアプリを起動します: make dev
- KumoApp はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/AstraFoundry/KumoApp
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
Linux上でClash / Mihomoのプロキシカーネルを実行するシェルベースのランナー。サブスクリプション管理、ノード選択、Tunモード、組み込みのdoctorコマンドに対応。
MacをSurge風の透過プロキシにするmacOS用ゲートウェイアプリ。デバイスごとのルーティングに対応し、dnsmasqでDHCP/DNS、mihomoでプロキシ処理を行います。