Kilobat CLI의 개요
Kilobat CLI는 프라하에 기반을 둔 개발자 Philip Seifi가 만든 Swift 기반 명령줄 도구로, macOS 14 이상에서 동작합니다. 어떤 앱이 회선을 쓰는지 보여 주고, Wi-Fi, DNS, 라우팅 문제를 진단하며, 특정 호스트에 연결되지 않는 이유를 설명하고, 긴 작업 동안 Mac이 잠들지 않게 합니다. kilobat mcp를 실행하면 CLI의 --json 출력과 같은 JSON을 반환하는 85개 도구를 갖춘 로컬 stdio MCP 서버가 시작됩니다.
CLI의 라이선스는 GPL-3.0-only입니다. 저장소는 2026년 10월 27일에 만들어졌고, v0.45.1은 2026년 11월 2일에 나왔으며, 확인 시점의 GitHub 스타는 1개였습니다. 많은 도구가 별도의 독점 제품인 Kilobat Mac 앱에 의존합니다. Wi-Fi 이름에는 앱의 위치 권한이 필요하고, 기록과 에이전트 네트워크 로그는 앱의 기록에서 나오며, 모든 차단에는 앱의 서명된 Network Extension이 필요합니다. 앱은 무료이고 Pro 업그레이드는 일회성 결제 $29입니다.
Kilobat CLI 설치 방법
brew install seifip/kilobat/kilobat && claude mcp add kilobat -- kilobat mcpKilobat CLI, 쓸 만한 가치가 있습니까?
Kilobat은 MCP 서버에서 드문 것을 코딩 에이전트에 줍니다. 바로 그 기기 자체의 네트워크 상황입니다. 패키지 설치가 멈추거나 API 호출이 시간 초과되면 diagnose_connection이 인터페이스, 프록시, DNS, TCP, TLS 계층을 차례로 살펴 실패한 계층을 짚어 냅니다. service_status는 에이전트 자신의 모델 제공업체가 장애를 보고하는지 확인하고, agent_network_log는 에이전트와 에이전트가 실행한 명령(npm, pip, curl, git)이 접속한 모든 호스트를 바이트 수와 함께 나열합니다. 85개 도구 대부분은 읽기 전용이며 MCP 주석에도 그렇게 표시합니다.
나머지 도구는 Mac을 바꾸며, 설치 여부는 이 도구들에 달려 있습니다. 서버 자체 지침은 사용자 설정을 바꾸는 15개 도구를 명시합니다. set_profile, set_app_rule, set_new_app_mode, block_destination, decide_approval, set_dns, set_fastest_dns, set_dns_fallback, set_budget, set_data_pack, set_app_quota, set_network_cost, set_updater_pause, set_kill_switch, set_protection입니다. clear_history는 기록을 삭제하며 되돌릴 수 없습니다. 이 목록 밖에서도 reconnect_wifi는 Wi-Fi를 몇 초간 끊고, hold_upload는 다른 앱의 업로드를 멈추며, keep_awake는 덮개를 닫은 Mac을 계속 켜 둘 수 있고, set_airdrop_visibility는 시스템 설정을 엽니다. 각 설명은 에이전트에 변경 내용을 설명하고 명시적 확인을 받으라고 지시하며, README는 권한 확인을 클라이언트가 제어한다고 밝힙니다. 이 지시를 무시하는 모델이 VPN 킬 스위치나 악성코드 차단 Protection을 끄는 것을 서버가 막지는 않습니다. 실제 관문이 있는 것은 set_dns뿐인데, macOS 자체가 관리자 암호를 요구하기 때문입니다.
쓰기 기능의 상당 부분은 동반 앱에도 의존합니다. 차단, 예산, 할당량, 업로드 보류, 킬 스위치는 Kilobat 앱의 네트워크 필터가 실행되는 동안에만 효과가 있고, 그중 여럿은 Pro 기능입니다. CLI만으로는 실시간 트래픽, 연결 진단, Wi-Fi 신호를 다룹니다. 에이전트가 MCP로 아무 효과 없는 규칙을 저장할 수 있다는 점은 README도 지적합니다. Homebrew formula는 소스에서 빌드하며 Xcode 16 이상이 필요하므로, 새 Mac에 처음 설치할 때는 컴파일이 포함됩니다.
README에 따르면 CLI에는 계정도 텔레메트리도 없고, 개인정보 고지에 따르면 트래픽 기록, 네트워크 이름, 규칙은 Mac에 남으며 앱의 PostHog 분석은 사용자가 동의하지 않는 한 꺼져 있습니다. 그래도 도구 결과는 프로세스 이름, 호스트 이름, 로컬 기기, 공인 IP를 모델 컨텍스트에 넣고, run_speedtest는 기본값으로 최대 80 MB를 전송하므로 데이터 요금제 핫스팟에서는 부담이 됩니다. 릴리스는 2026년 11월 2일 하루 만에 v0.30.0에서 v0.45.1까지 올라갔습니다. 이렇게 새로운 프로젝트에서는 소스 코드가 유일한 이력입니다.
제 역할을 하는 곳
MacBook에서 Claude Code를 쓰는 백엔드 개발자
에이전트의 패키지 설치나 API 호출이 계속 멈추는 이유를 찾기
에이전트가 실패한 호스트에 diagnose_connection을, 제공업체에 service_status를 호출한 뒤 DNS, 경로, VPN, 원격 서비스 중 무엇이 원인인지 보고합니다. CLI만으로 무료이며 Mac에서 바뀌는 것은 없습 니다.
에이전트의 의존성 설치를 검토하는 보안 의식 높은 엔지니어
에이전트 세션 동안 npm이나 pip 설치가 접속한 모든 호스트 확인하기
Kilobat 앱이 기록 중이면 agent_network_log가 세션별 호스트, 바이트 수, 경고를 반환하고, check_host_reputation이 각 호스트를 로컬에 내려받은 위협 목록과 대조합니다. 호스트 정보는 어디로도 전송되지 않습니다.
호텔과 카페 Wi-Fi에서 일하는 컨설턴트
회선이 긴 빌드나 5 GB 다운로드를 감당할 수 있는지 판단하기
get_conditions가 데이터 요금제 회선, 저데이터 모드, VPN, 배터리, 발열을 보고하고, get_captive_portal이 장애처럼 보이는 로그인 페이지를 잡아냅니다. 에이전트가 더 작은 예산을 넘기지 않으면 핫스팟 속도 테스트에 최대 80 MB가 듭니다.
도입 전 확인할 점
- 설정
- brew install seifip/kilobat/kilobat(소스에서 빌드, macOS 14 이상, Xcode 16 이상) 후 claude mcp add kilobat -- kilobat mcp 또는 codex의 같은 명령을 실행합니다. kilobat.app에 13개 클라이언트용 가이드가 있으며, Claude Desktop에는 /usr/bin/which kilobat이 반환하는 전체 경로가 필요합니다.
- 연동
- v0.45.1 기준 85개 도구: 트래픽, Wi-Fi와 메시 노드, DNS 비교, traceroute, VPN 유출 검사, 속도 테스트와 iperf3 LAN 테스트, 캡티브 포털, Starlink, 스마트 홈 점검. 읽기 전용 도구에는 readOnly, 설정 도구에는 destructive 주석이 붙습니다.
- 데이터와 개인정보
- stdio로 로컬 실행되며 포트를 열지 않습니다. CLI에는 계정도 텔레메트리도 없으며, 점검은 테스트 엔드포인트에 접속하고 속도 테스트는 Cloudflare를 씁니다. 출력(프로세스 이름, 호스트, 로컬 기기, 공인 IP)은 모델 제공업체로 갑니다. 쓰기 도구는 DNS 변경, 앱과 도메인 차단, VPN 킬 스위치나 Protection 끄기, 기록 삭제를 할 수 있으며 확인은 클라이언트에 맡겨집니다.
- 대규모 사용 시 비용
- 무료입니다. Kilobat Pro에 기반한 도구에는 앱의 일회성 $29 라이선스가 필요하며, run_speedtest는 기본값으로 호출당 최대 80 MB를 전송합니다.
- 제한
- macOS 전용입니다. 차단, 예산, 할당량, 업로드 보류, 킬 스위치에는 앱의 Network Extension 활성화가 필요하고, Wi-Fi 이름에는 위치 권한이 필요합니다. 85개 도구 정의가 매 세션에 로드됩니다.
좋은 점
- 호스트가 실패하는 이유를 계층별로 설명
- 에이전트 명령이 접속한 호스트를 기록
- 읽기와 쓰기 도구에 MCP 주석 제공
- CLI는 계정과 텔레메트리 없음
아쉬운 점
- 설정 변경 확인은 권고에 그침
- 차단과 예산에는 독점 앱이 필요
- macOS 14 이상 전용, Homebrew 빌드에 Xcode 16 필요
- 공개 2주, GitHub 스타 1개
추천 대상
코딩 에이전트를 로컬에서 돌리며 에이전트가 자기 네트워크 장애를 진단하게 하려는 Mac 개발자로, 쓰기 도구마다 확인하도록 클라이언트를 설정할 수 있는 사람.
Kilobat CLI: 자주 묻는 질문
- Kilobat CLI, 쓸 만한 가치가 있습니까?
- 에이전트용으로 세심하게 만든 Mac 네트워크 도구이지만, 상태를 바꾸는 20개 도구가 사전 확인을 서버가 아닌 클라이언트에 맡긴 다는 점이 발목을 잡습니다. 평점은 5점 만점에 3.6점입니다.
- Kilobat CLI의 가격은 얼마입니까?
- CLI와 MCP 서버는 GPL-3.0-only로 무료입니다. 선택 사항인 Kilobat Mac 앱은 무료이며, 차단 프로필, 예산, 기록 등을 더하는 Pro는 일회성 $29(14일 환불)입니다.
- Kilobat CLI의 단점은 무엇입니까?
- 설정 변경 확인은 권고에 그침; 차단과 예산에는 독점 앱이 필요; macOS 14 이상 전용, Homebrew 빌드에 Xcode 16 필요; 공개 2주, GitHub 스타 1개.
- Kilobat CLI에 적합한 사람은 누구입니까?
- 코딩 에이전트를 로컬에서 돌리며 에이전트가 자기 네트워크 장애를 진단하게 하려는 Mac 개발자로, 쓰기 도구마다 확인하도록 클라이언트를 설정할 수 있는 사람.
- 팀이나 프로덕션 환경에서 Kilobat CLI의 비용은 얼마입니까?
- 무료입니다. Kilobat Pro에 기반한 도구에는 앱의 일회성 $29 라이선스가 필요하며, run_speedtest는 기본값으로 호출당 최대 80 MB를 전송합니다.
- Kilobat CLI에 회사 데이터를 맡겨도 안전합니까?
- stdio로 로컬 실행되며 포트를 열지 않습니다. CLI에는 계정도 텔레메트리도 없으며, 점검은 테스트 엔드포인트에 접속하고 속도 테스트는 Cloudflare를 씁니다. 출력(프로세스 이름, 호스트, 로컬 기기, 공인 IP)은 모델 제공업체로 갑니다. 쓰기 도구는 DNS 변경, 앱과 도메인 차단, VPN 킬 스위치나 Protection 끄기, 기록 삭제를 할 수 있으며 확인은 클라이언트에 맡겨집니다.
답변 확인일: 2026년 11월 11일.