Set up Kilobat in Cline

Install the CLI

The Kilobat CLI is free and open source, and it includes the MCP server. Install it with Homebrew:

Check it with kilobat --version. kilobat doctor says whether the Kilobat app is running, its network filter is on and Pro is active; the tools work without the app, which adds Wi-Fi names, history and rule enforcement. The CLI needs macOS 14 or later.

Connect the MCP server

1. In the extension, click the MCP Servers icon at the top of the Cline panel, open Configure, then Configure MCP Servers. It opens cline_mcp_settings.json.

2. Add Kilobat. List only read-only tools in autoApprove, or none:

   {
     "mcpServers": {
       "kilobat": {
         "command": "kilobat",
         "args": [
           "mcp"
         ],
         "disabled": false,
         "autoApprove": [
           "get_status",
           "diagnose_network",
           "get_conditions"
         ]
       }
     }
   }

3. In the Cline CLI, add it from the terminal. It writes ~/.cline/data/settings/cline_mcp_settings.json.

   cline mcp add kilobat --yes -- kilobat mcp

An app opened from the Dock doesn't always see the PATH your shell uses. If the server doesn't start, replace kilobat with the full path that command -v kilobat prints: /opt/homebrew/bin/kilobat on Apple silicon, /usr/local/bin/kilobat on Intel.

Add the skills

Nine Agent Skills teach the agent to read Kilobat's measurements and to ask before changing settings. Install them for all your projects with skills.sh:

npx skills add seifip/kilobat-skills -g -a cline

This puts them in ~/.agents/skills/. Leave out -g to install them for the current project only, or leave out both flags to pick agents from a list.

The kilobat skill is the entry point: it holds the setup and safety rules and sends the agent to the skill that fits, such as mac-network-troubleshooting or mac-agent-runs. See all nine skills.

Try these prompts

Ask in plain words. The agent picks the tools; these are the ones each request usually needs.

What Cline can and can't change

Kilobat's MCP server marks every tool as read-only or as a change, and each change tool's description tells the agent to get your confirmation first. The kilobat skill holds the same rule: read freely, ask before changing.

Runs without asking

• Measure Wi-Fi, router, internet and DNS latency, and per-app traffic: diagnose_network, get_status, get_wifi, scan_wifi.
• Find the layer that stops one host, trace a route and compare resolvers: diagnose_connection, trace_route, benchmark_dns.
• Read history, sessions, rules and approvals: get_usage_report, list_sessions, list_rules, list_approvals.
• Ping for latency spikes with run_stutter_test, which sends pings only.

Asks you first

• A speed test, which uses up to 80 MB (run_speedtest; on a metered network, 10 MB or less), and a five-second LAN test (run_lan_test).
• Looking up your public IP with Cloudflare (get_exit_path with public_ip).
• Profiles, app rules, blocked hosts, the new-app mode, budgets, quotas, a network's data cost and pausing updaters (set_profile, set_app_rule, block_destination, set_new_app_mode, set_budget, set_app_quota, set_network_cost, set_updater_pause).
• DNS, which macOS also guards with an administrator password prompt (set_dns).
• Keeping the Mac running with the lid closed, every time (keep_awake with lid_closed). A plain keep_awake changes no settings and ends when it expires.

Can't do

• Let a waiting app connect on its own: decide_approval can block at once, but allowing opens Kilobat's approval window for you to confirm.
• Change AirDrop visibility: set_airdrop_visibility opens System Settings for you.
• Change sleep settings, another app's settings, or anything outside Kilobat. It never reads prompts or replies.
• Enforce rules without the Kilobat app and its network filter (Pro). Without them, rules are saved, not applied, and the agent should say so.

Cline asks before each tool call that isn't in autoApprove. Never add Kilobat's set_, block_destination or decide_approval tools there.

If the agent can also run shell commands, the kilobat CLI can do what the MCP tools do. The skills tell it which commands to run freely and which to ask about.

Track agent runs

For the Cline CLI, SDK and Kanban, install Kilobat's plugin. It adds one file to Cline's plugin store and changes no other settings. Cline's plugins don't run in the VS Code or JetBrains extensions yet.

cline plugin install https://kilobat.app/agents/cline/kilobat.ts

It reports a run working, done, failed while Cline stays open, cancelled, rate-limited once Cline's own retries run out, and waiting while Cline asks you a question. It waits for subagents and teammates before calling a run done. Cline's approval prompts aren't visible to plugins, so traffic and CPU detection covers those. cline plugin uninstall kilobat removes it.

Sources

• Cline docs: Configuring MCP servers
• Kilobat's Cline plugin, one TypeScript file
• Kilobat docs: AI agents and MCP
• skills.sh: supported agents and their skill folders

Checked on 30 October 2026. Agents change their settings often; if a step no longer matches, tell us at the support address.

Other agents