AI agents

Set up Kilobat in your AI agent

Kilobat gives coding agents and assistants your Mac's network as tools: per-app traffic, Wi-Fi, DNS, why a host fails, whether the network is metered, and keep-awake for long runs. Pick your agent for its exact setup.

Free CLI and MCP server9 setupsChecked: 30 October 2026

Pick your agent

Claude CodeGive Claude Code your Mac's network as tools: per-app traffic, Wi-Fi, DNS, why a host fails and keep-awake.Set up Claude Code →Codex CLICodex can check the network before a big download, find why its own request hangs and keep the Mac awake for a long task.Set up Codex CLI →CursorLet Cursor's agent see why a package download hangs, which app is using the connection and whether the network is metered before a big pull.Set up Cursor →Gemini CLIGemini CLI can diagnose the Mac's network, scan Wi-Fi and keep the Mac awake while it works.Set up Gemini CLI →Claude DesktopAsk Claude why the Wi-Fi is slow, what used your hotspot data or whether your VPN carries everything, and it reads the answer from your Mac.Set up Claude Desktop →WindsurfCascade can find why a dependency won't download, check DNS and trace a route from your Mac, with Kilobat's MCP server.Set up Windsurf →ClineCline can check the Mac's network and keep it awake while it works.Set up Cline →ZedZed's agent can measure the Mac's network, trace a route and compare DNS resolvers through Kilobat's MCP server.Set up Zed →Any MCP clientKilobat's MCP server is a local stdio command, kilobat mcp.Set up Any MCP client →

At a glance

Agent	Add the MCP server	Run tracking
Claude Code	`claude mcp add --scope user kilobat -- kilobat mcp`	Hooks
Codex CLI	`codex mcp add kilobat -- kilobat mcp`	notify or hooks
Cursor	`mcp.json`	Traffic and CPU
Gemini CLI	`gemini mcp add -s user kilobat kilobat mcp`	Hooks
Claude Desktop	`.mcpb` extension or `claude_desktop_config.json`	Traffic and CPU
Windsurf	`mcp_config.json`	Traffic and CPU
Cline	`cline mcp add kilobat --yes -- kilobat mcp`	Plugin
Zed	`context_servers` in settings	Traffic and CPU
Any MCP client	`kilobat mcp`	Traffic and CPU

Run tracking tells Kilobat when a run works, waits for you or is done, so it keeps the Mac awake only while the agent is busy. Without hooks, Kilobat goes by the agent's traffic and CPU.

Every setup

Install the CLI, which includes the MCP server.
```
brew install seifip/kilobat/kilobat
```

Add kilobat mcp to the agent as a local stdio server.

{
  "mcpServers": {
    "kilobat": {
      "command": "kilobat",
      "args": [
        "mcp"
      ]
    }
  }
}

Add the skills, which teach the agent to read the results and to ask before changing settings.
```
npx skills add seifip/kilobat-skills
```

Read-only tools run freely. Tools that change settings are annotated as destructive and tell the agent to ask you first. See AI agents and MCP in the docs for every tool, and llms-full.txt for the whole documentation as one Markdown file.