Skip to main content
Glama

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 seifip/kilobat-skills.

Ask your agent things like "why is my internet slow?", "is this a hotspot before I download 5 GB?", "why can't this API connect from my Mac?" or "keep the Mac awake until this build finishes".

Related MCP server: AppleScript Automation MCP

Install with Homebrew

brew install seifip/kilobat/kilobat

This builds from source and requires Xcode 16 or newer.

Build

Requires macOS 14 or later and Swift 6.

swift build -c release
.build/release/kilobat --help
swift test

Run kilobat --help for commands and kilobat mcp --help for agent integration. Commands that change system settings may require confirmation and administrator authorization.

macOS shows Wi-Fi network names only to apps with Location permission. When the Kilobat app is running, the CLI reads names, filter status and per-network budgets from it; without the app, Wi-Fi signal, channels and everything else still work, but network names read as hidden.

License

Kilobat CLI and the source in this repository are licensed under the GNU General Public License version 3.0 only; see LICENSE. Kilobat's name and artwork are not licensed for use as trademarks. The separate Kilobat desktop app is distributed under its own terms.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    MCP server that enables AI to fully control macOS — mouse, keyboard, terminal, screenshots, window management, UI element detection, and provides AI-optimized information reporting.
    36
    33 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Actvt's embedded MCP server for macOS. 25 tools for live CPU, GPU, memory and network metrics, listening ports with a guarded port_kill, and Claude Code and Codex session analytics (cost, tokens, transcript search, error patterns). It ships inside the Actvt macOS app and binds to loopback on the user's machine, so it starts with the app, not as a standalone or containerised process.
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to discover and interact with iOS apps through a local MCP gateway, converting remote Streamable HTTP MCP endpoints into stdio tools. Provides dynamic device discovery, tool schema introspection, and deterministic tool calling for app analysis.
    -