에이전트 설정
OpenCode에 Kilobat 설정하기
OpenCode는 Kilobat으로 Mac의 트래픽을 살펴보고 연결 실패를 설명하며 긴 작업 중 잠자기를 방지할 수 있습니다.
CLI 설치
Kilobat CLI는 무료 오픈 소스이며 MCP 서버를 포함합니다. Homebrew로 설치하세요.
brew install seifip/kilobat/kilobatkilobat --version로 확인하세요. kilobat doctor는 Kilobat 앱이 실행 중인지, 네트워크 필터가 켜져 있는지, Pro가 활성화되어 있는지 알려줍니다. 도구는 앱 없이도 작동하며 앱을 사용하면 Wi-Fi 이름, 기록 및 규칙 적용 기능이 추가됩니다. CLI에는 macOS 14 이상이 필요합니다.
MCP 서버 연결
확인하려는 Mac에서 에이전트 백엔드와 Kilobat을 실행하세요. 클라우드 러너, Linux 서버 또는 컨테이너는 이 로컬 명령으로 Mac을 검사할 수 없습니다.
이 내용을 프로젝트의
opencode.json또는 전역~/.config/opencode/opencode.json에 병합합니다.{ "mcp": { "kilobat": { "type": "local", "command": ["kilobat", "mcp"], "enabled": true } }, "permission": { "kilobat_*": "ask" } }구성한 서버를 확인한 다음 새 OpenCode 세션을 시작합니다.
opencode mcp list
이 예시는 현재 안정 버전의 OpenCode 문서를 따릅니다. OpenCode v2는 대신 mcp.servers 및 disabled를 사용합니다. 해당 버전을 사용한다면 버전에 맞는 문서를 참고하세요.
스킬 추가
9개의 Agent Skills는 에이전트가 Kilobat의 측정값을 읽고 설정을 변경하기 전에 묻도록 알려줍니다. skills.sh를 사용해 모든 프로젝트에 설치하세요.
npx skills add seifip/kilobat-skills -g -a opencode이렇게 하면 ~/.config/opencode/skills/에 설치됩니다. -g를 생략하면 현재 프로젝트에만 설치되며, 두 플래그를 모두 생략하면 목록에서 에이전트를 선택할 수 있습니다.
kilobat 스킬이 진입점입니다. 설정 및 안전 규칙을 담고 있으며 mac-network-troubleshooting 또는 mac-agent-runs처럼 적합한 스킬로 에이전트를 안내합니다. 9개 스킬 전체를 확인하세요.
이 프롬프트를 사용해 보세요
일상적인 말로 요청하세요. 에이전트가 도구를 선택합니다. 아래는 각 요청에 일반적으로 필요한 도구입니다.
| 묻기 | MCP 도구 |
|---|---|
| 인터넷이 느린 것 같습니다. 이유를 찾아서 무엇부터 고쳐야 할지 알려주세요. | diagnose_network, get_status |
| npm install이 registry.npmjs.org에서 멈춥니다. 문제가 발생한 계층을 찾아주세요. | diagnose_connection |
| 전체 테스트를 실행하는 동안 앞으로 두 시간 동안 Mac의 잠자기를 방지하고, 끝나면 해제하세요. | keep_awake, release_awake |
| 어떤 항목이 데이터를 많이 업로드하고 있습니다. 어떤 앱이며 지난 한 시간 동안 얼마나 전송했나요? | get_status, get_app_bandwidth |
| 페이지가 로드되기까지 오래 걸립니다. DNS 리졸버를 비교하고 전환하면 도움이 될지 알려 주세요. 아직 아무것도 변경하지 마세요. | benchmark_dns, diagnose_network |
OpenCode에서 변경할 수 있는 것과 없는 것
Kilobat의 MCP 서버는 모든 도구를 읽기 전용 또는 변경 도구로 표시하며, 각 변경 도구의 설명에는 에이전트가 먼저 확인을 받도록 안내합니다. kilobat 스킬에도 같은 규칙이 있습니다. 읽기는 자유롭게 하고 변경 전에는 묻습니다.
읽기 전용 측정
- Wi-Fi, 라우터, 인터넷 및 DNS 지연 시간과 앱별 트래픽 측정:
diagnose_network,get_status,get_wifi,scan_wifi. - 특정 호스트를 막는 계층을 찾고, 경로를 추적하고, 리졸버 비교:
diagnose_connection,trace_route,benchmark_dns. - 기록, 세션, 규칙 및 승인 읽기:
get_usage_report,list_sessions,list_rules,list_approvals. - 에이전트와 실행한 명령이 접속한 모든 호스트를 바이트 및 플래그와 함께 확인:
agent_network_log. run_stutter_test로 지연 시간 급증을 확인합니다. 이 도구는 ping만 전송합니다.
먼저 확인하는 작업
- 최대 80 MB를 사용하는 속도 테스트(
run_speedtest, 데이터 제한 네트워크에서는 10 MB 이하)와 5초 LAN 테스트(run_lan_test). - Cloudflare로 공인 IP 조회(
public_ip를 사용하는get_exit_path). - 프로필, 앱 규칙, 차단된 호스트, 새 앱 모드, 데이터 한도, 할당량, 네트워크의 데이터 비용 및 업데이터 일시 정지(
set_profile,set_app_rule,block_destination,set_new_app_mode,set_budget,set_app_quota,set_network_cost,set_updater_pause). - 더 좋은 네트워크에 연결할 때까지 Dropbox 같은 다른 앱의 업로드 보류(
hold_upload). - DNS 변경. macOS에서도 관리자 암호를 요청하여 보호합니다(
set_dns). - 덮개를 닫은 상태에서 Mac을 계속 실행할 때마다 확인합니다(
lid_closed를 사용하는keep_awake). 일반keep_awake는 설정을 변경하지 않으며 시간이 만료되면 종료됩니다.
할 수 없는 작업
- 대기 중인 앱이 자동으로 연결되도록 허용:
decide_approval는 즉시 차단할 수 있지만 허용하려면 Kilobat의 승인 창이 열려 직접 확인해야 합니다. - AirDrop 공개 범위 변경:
set_airdrop_visibility는 시스템 설정을 엽니다. - 잠자기 설정, 다른 앱의 설정 또는 Kilobat 외부의 항목 변경. 프롬프트나 응답은 읽지 않습니다.
- Kilobat 앱과 네트워크 필터(Pro) 없이 규칙 적용. 이들이 없으면 규칙은 저장되지만 적용되지 않으며 에이전트가 이를 알려야 합니다.
이 예시는 모든 Kilobat 도구를 사용하기 전에 확인을 요청합니다. 이 정책의 범위를 좁힐 때도 변경에 대한 확인은 유지하세요. MCP 주석만으로는 권한 규칙이 되지 않습니다.
에이전트가 셸 명령도 실행할 수 있다면 kilobat CLI로 MCP 도구가 수행하는 작업을 할 수 있습니다. 스킬은 자유롭게 실행할 명령과 먼저 확인할 명령을 알려줍니다.
에이전트 실행 추적
Kilobat은 트래픽과 CPU 기반 활동을 통해 OpenCode 프로세스를 인식합니다. 활동이 없는 프로세스는 입력 대기 중이거나 완료된 상태일 수 있습니다. Kilobat에는 바로 쓸 수 있는 OpenCode 훅 어댑터가 없습니다. 사용자화한 연동에서 kilobat agent-event를 사용할 수 있습니다. 에이전트 연결을 참고하세요.
출처
2026년 11월 1일 확인했습니다. 에이전트 설정은 자주 변경됩니다. 단계가 더 이상 일치하지 않으면 지원 주소로 알려 주세요.
