AstraFoundry/KumoApp
Go, React UI와 에이전트 친화적인 CLI로 만든 차분한 Mihomo 프록시 코어 데스크톱 클라이언트입니다.
- 스타
- 299
- 포크
- 13
- 열린 이슈
- 5
- 마지막 커밋
- 16일 전
어떤 프로젝트인가요?
Kumo는 Mihomo 프록시 코어를 관리하는 데스크톱 클라이언트입니다. 첫 화면에서 Kumo의 연결 여부, 활성 모드, 시스템 프록시 사용 여부, 현재 프로필과 노드를 확인할 수 있습니다. DNS, TUN, 규칙, 로그, 오버라이드와 라우팅 토폴로지 뷰는 각각 별도 페이지에서 이용할 수 있습니다.
앱은 MyGo로 빌드한 단일 Go 바이너리이며, 프런트엔드는 coss ui를 사용하는 React로 구현했습니다. 메뉴 바 항목과 알림도 제공합니다. Kumo가 종료되거나 guardian 프로세스가 충돌을 감지하면 코어를 중지하고 시스템 프록시 설정을 해제하되, Kumo가 여전히 해당 설정을 관리하는 경우에만 처리합니다. 다른 앱이 시스템 프록시를 차지했거나 포트가 이미 사용 중이면, Kumo는 설정을 덮어쓰는 대신 충돌을 알립니다.
같은 실행 파일을 `kumo` CLI로도 사용할 수 있으며, `--json` 출력, dry-run 지원과 예측 가능한 종료 코드를 제공합니다. 각 페이지에서 코딩 에이전트용 프롬프트를 복사할 수 있고, Claude Code, Codex, Cursor, Gemini CLI에 Kumo skill을 설치할 수도 있습니다.
핵심 기능
- 01연결 상태, 활성 모드, 시스템 프록시 상태와 현재 프로필을 보여주는 개요 화면.
- 02진입점, 규칙, 그룹과 노드를 연결하고 끊어진 참조를 강조 표시하는 토폴로지 캔버스.
- 03Kumo가 시스템 프록시와 코어를 여전히 관리하는 경우에만 종료 또는 충돌 시 프록시 설정을 복구하고 코어를 중지합니다.
- 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 프록시 코어 데스크톱 클라이언트입니다. Kumo는 Mihomo 프록시 코어를 관리하는 데스크톱 클라이언트입니다. 첫 화면에서 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를 지원합니다.