Configuração do agente
Configure o Kilobat no OpenCode
O OpenCode pode inspecionar o tráfego do Mac, explicar conexões que falharam e manter o Mac ativo durante tarefas longas com o Kilobat.
Instale a CLI
A CLI do Kilobat é gratuita, de código aberto e inclui o servidor MCP. Instale-a com o Homebrew:
brew install seifip/kilobat/kilobatVerifique com kilobat --version. kilobat doctor informa se o app Kilobat está em execução, se o filtro de rede está ativado e se o Pro está ativo; as ferramentas funcionam sem o app, que acrescenta nomes de redes Wi-Fi, histórico e aplicação de regras. A CLI exige macOS 14 ou posterior.
Conecte o servidor MCP
Execute o backend do agente e o Kilobat no Mac que deseja verificar. Um executor na nuvem, servidor Linux ou contêiner não pode usar esse comando local para inspecionar seu Mac.
Mescle isto em
opencode.jsondo projeto ou em seu~/.config/opencode/opencode.jsonglobal.{ "mcp": { "kilobat": { "type": "local", "command": ["kilobat", "mcp"], "enabled": true } }, "permission": { "kilobat_*": "ask" } }Confira o servidor configurado e inicie uma nova sessão do OpenCode.
opencode mcp list
O exemplo segue a documentação estável atual do OpenCode. O OpenCode v2 usa mcp.servers e disabled; use a documentação da versão se for essa que você executa.
Adicione as skills
Nove Agent Skills ensinam o agente a ler as medições do Kilobat e a pedir autorização antes de alterar ajustes. Instale-as para todos os seus projetos com skills.sh:
npx skills add seifip/kilobat-skills -g -a opencodeIsso as coloca em ~/.config/opencode/skills/. Omita -g para instalá-las apenas no projeto atual ou omita as duas opções para escolher agentes em uma lista.
A skill kilobat é o ponto de entrada: ela contém as regras de configuração e segurança e encaminha o agente para a skill adequada, como mac-network-troubleshooting ou mac-agent-runs. Veja as nove skills.
Experimente estes prompts
Peça em linguagem comum. O agente escolhe as ferramentas; estas são as que cada solicitação costuma exigir.
| Perguntar | Ferramentas MCP |
|---|---|
| A internet parece lenta. Descubra por quê e diga o que devo corrigir primeiro. | diagnose_network, get_status |
| npm install fica travado em registry.npmjs.org. Descubra qual camada está falhando. | diagnose_connection |
| Mantenha o Mac ativo pelas próximas duas horas enquanto executa toda a suíte de testes e depois libere-o. | keep_awake, release_awake |
| Algum app está enviando muitos dados. Qual é e quanto enviou na última hora? | get_status, get_app_bandwidth |
| As páginas demoram para começar a carregar. Compare os resolvedores de DNS e diga se trocar ajudaria. Ainda não altere nada. | benchmark_dns, diagnose_network |
O que o OpenCode pode e não pode alterar
O servidor MCP do Kilobat marca cada ferramenta como somente leitura ou de alteração, e a descrição de cada ferramenta de alteração orienta o agente a pedir sua confirmação primeiro. A skill kilobat segue a mesma regra: ler livremente e perguntar antes de alterar.
Medições somente de leitura
- Meça a latência do Wi-Fi, do roteador, da internet e do DNS, além do tráfego por app:
diagnose_network,get_status,get_wifi,scan_wifi. - Encontre a camada que impede a conexão com um host, rastreie uma rota e compare resolvedores:
diagnose_connection,trace_route,benchmark_dns. - Consulte histórico, sessões, regras e aprovações:
get_usage_report,list_sessions,list_rules,list_approvals. - Verifique todos os hosts contatados pelo agente e pelos comandos que ele executou, com bytes e sinalizações:
agent_network_log. - Use
run_stutter_testpara verificar picos de latência; ele envia apenas pings.
Pergunta antes
- Um teste de velocidade, que usa até 80 MB (
run_speedtest; em uma rede com limite de dados, 10 MB ou menos), e um teste de LAN de cinco segundos (run_lan_test). - Consultar seu IP público com a Cloudflare (
get_exit_pathcompublic_ip). - Perfis, regras de apps, hosts bloqueados, modo para novos apps, orçamentos, cotas, custo de dados de uma rede e pausa de atualizadores (
set_profile,set_app_rule,block_destination,set_new_app_mode,set_budget,set_app_quota,set_network_cost,set_updater_pause). - Suspender o envio de outro app, como o Dropbox, até haver uma rede melhor (
hold_upload). - DNS, que o macOS também protege com uma solicitação de senha de administrador (
set_dns). - Manter o Mac funcionando com a tampa fechada, todas as vezes (
keep_awakecomlid_closed). Umkeep_awakesimples não altera ajustes e termina quando expira.
Não pode fazer
- Permitir que um app em espera se conecte por conta própria:
decide_approvalpode bloquear imediatamente, mas permitir abre a janela de aprovação do Kilobat para você confirmar. - Alterar a visibilidade do AirDrop:
set_airdrop_visibilityabre os Ajustes do Sistema para você. - Alterar os ajustes de repouso, os ajustes de outro app ou qualquer coisa fora do Kilobat. Ele nunca lê prompts ou respostas.
- Aplicar regras sem o app Kilobat e seu filtro de rede (Pro). Sem eles, as regras são salvas, mas não aplicadas, e o agente deve informar isso.
O exemplo pede confirmação antes de cada ferramenta do Kilobat. Ao restringir essa política, mantenha a confirmação para alterações; anotações MCP, por si só, não são uma regra de permissão.
Se o agente também puder executar comandos do shell, a CLI kilobat poderá fazer o que as ferramentas MCP fazem. As skills informam quais comandos ele pode executar livremente e sobre quais deve perguntar.
Acompanhe as execuções do agente
O Kilobat reconhece o processo do OpenCode para acompanhar a atividade com base em tráfego e CPU. Um processo sem atividade pode estar aguardando ou ter terminado. O Kilobat não tem um adaptador de hook pronto para OpenCode; integrações personalizadas podem usar kilobat agent-event. Consulte Conectar agentes.
Fontes
- OpenCode: servidores MCP
- OpenCode: permissões
- OpenCode v2: servidores MCP
- Documentação do Kilobat: agentes de IA e MCP
- skills.sh: agentes compatíveis e suas pastas de skills
Verificado em 1º de novembro de 2026. Os agentes mudam suas configurações com frequência; se alguma etapa não corresponder mais, avise-nos pelo endereço de suporte.
