Configuração do agente
Configure o Kilobat no Cline
O Cline pode verificar a rede do Mac e mantê-lo ativo enquanto trabalha. O plugin do Cline para Kilobat informa cada execução como trabalhando, aguardando você, concluída ou com falha.
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.
Na extensão, clique no ícone MCP Servers no topo do painel Cline, abra Configure e depois Configure MCP Servers. Isso abre
cline_mcp_settings.json.Adicione o Kilobat. Liste apenas ferramentas de leitura em
autoApprove, ou nenhuma:{ "mcpServers": { "kilobat": { "command": "kilobat", "args": [ "mcp" ], "disabled": false, "autoApprove": [ "get_status", "diagnose_network", "get_conditions" ] } } }Na CLI do Cline, adicione-o pelo Terminal. Ela grava
~/.cline/data/settings/cline_mcp_settings.json.cline mcp add kilobat --yes -- kilobat mcp
Um app aberto pelo Dock nem sempre vê o PATH usado pelo seu shell. Se o servidor não iniciar, substitua kilobat pelo caminho completo que command -v kilobat imprime: /opt/homebrew/bin/kilobat no Apple silicon e /usr/local/bin/kilobat no Intel.
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 clineIsso as coloca em ~/.agents/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 |
| As execuções dos meus agentes hoje terminaram ou alguma travou ou perdeu a conexão? | list_sessions |
| Vou baixar uma imagem Docker de 6 GB. Este é um bom momento ou estou em uma rede com limite de dados? | get_conditions |
| Minhas videochamadas travam embora os testes de velocidade pareçam normais. Verifique se há picos de latência. | run_stutter_test, get_nearby_radios |
O que o Cline 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 Cline pede autorização antes de cada chamada de ferramenta que não esteja em autoApprove. Nunca adicione ali as ferramentas set_, block_destination ou decide_approval do Kilobat.
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
Para a CLI, o SDK e o Kanban do Cline, instale o plugin do Kilobat. Ele adiciona um arquivo à loja de plugins do Cline e não altera outros ajustes. Os plugins do Cline ainda não funcionam nas extensões para VS Code ou JetBrains.
cline plugin install https://kilobat.app/agents/cline/kilobat.tsEle informa que uma execução está trabalhando, concluída, falhou enquanto o Cline permanece aberto, foi cancelada, teve limite de taxa atingido após esgotar as tentativas do Cline, ou está aguardando enquanto o Cline faz uma pergunta. Ele espera subagentes e colegas terminarem antes de marcar a execução como concluída. Os pedidos de aprovação do Cline não ficam visíveis para plugins, então a detecção de tráfego e CPU cobre esses casos. cline plugin uninstall kilobat o remove.
Fontes
- Documentação do Cline: configurar servidores MCP
- Plugin do Kilobat para Cline, um arquivo TypeScript
- Documentação do Kilobat: agentes de IA e MCP
- skills.sh: agentes compatíveis e suas pastas de skills
Verificado em 30 de outubro de 2026. Os agentes alteram seus ajustes com frequência; se uma etapa não corresponder mais, avise-nos pelo endereço de suporte.
