// readme

Kilobat CLI

Kilobat is a macOS command-line tool and MCP server for network monitoring and diagnostics: which apps use the network, Wi-Fi signal and channels, latency and packet loss, DNS, speed tests, why one host or API won’t connect, where traffic leaves (VPN or not), metered hotspots and data budgets, and keeping the Mac awake while long jobs and AI agents run. Every command speaks JSON. The native Kilobat menu-bar app is a separate product: https://kilobat.app.

Use with AI agents (MCP)

kilobat mcp is a stdio MCP server with 43 tools. Read-only tools need no confirmation; tools that change something tell the agent to ask you first.

  • Claude Code: claude mcp add kilobat -- kilobat mcp
  • Codex CLI: codex mcp add kilobat -- kilobat mcp
  • Claude Desktop: download kilobat-mcp-<version>.mcpb from Releases and open it.
  • Cursor, Windsurf, Zed, Gemini CLI, Cline and others: add a stdio server with command kilobat and argument mcp.

Step-by-step setup for each agent, with example prompts: https://kilobat.app/agents/. Agent skills that teach agents when and how to use Kilobat: `npx skills add…