cosmotop

Overview

Cosmotop is a fork of btop++ built with Cosmopolitan Libc, designed as a single executable that runs on multiple platforms. It provides comprehensive system monitoring capabilities including CPU, memory, disk, network, GPU, NPU, and container metrics. When started with the --mcp flag, it operates as an MCP server, exposing system information tools via the Model Context Protocol while disabling the graphical interface. The implementation uses the STDIO transport and supports protocol version 2024-11-05, making it suitable for integration with AI assistants and automation workflows.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_process_info

  Get information about running processes

  Try:Show me the top 5 processes by CPU usageTry:List all running processes with their memory usage
• get_cpu_info

  Get CPU information and usage statistics

  Try:Show me current CPU utilizationTry:What's the average CPU load over the last minute?
• get_memory_info

  Get system memory information and usage statistics

  Try:How much RAM is being used?Try:Show me memory usage breakdown
• get_network_info

  Get network interface statistics and usage

  Try:Show network bandwidth usageTry:List active network connections
• get_disk_info

  Get disk usage and I/O statistics

  Try:Show disk space usageTry:List mounted file systems with their usage
• get_gpu_info

  Get GPU information and usage statistics

  Try:Show GPU utilizationTry:What's the GPU temperature?
• get_npu_info

  Get NPU information and usage statistics

  Try:Show NPU utilizationTry:What's the NPU status?
• get_container_info

  Get container information and usage statistics

  Try:List running containersTry:Show container resource usage
• get_system_info

  Get general system information

  Try:Show system detailsTry:List system specifications

Comparable tools

Installation

brew tap bjia56/tap
brew install cosmotop

docker run -it --rm --net=host --pid=host ghcr.io/bjia56/cosmotop:latest

{
  "mcpServers": {
    "cosmotop": {
      "command": "path/to/cosmotop",
      "args": ["--mcp"]
    }
  }
}

FAQ

What tools are exposed by cosmotop in MCP mode?

Cosmotop exposes several tools: get_process_info, get_cpu_info, get_memory_info, get_network_info, get_disk_info, get_gpu_info, get_npu_info, get_container_info, and get_system_info. GPU and NPU tools are only available if the respective hardware is detected.

Which platforms are supported by cosmotop?

Cosmotop supports Linux (x86_64, i386, aarch64, etc.), Windows 10+, MacOS 13+, and various BSD distributions. Core platforms (Linux x86_64/aarch64, MacOS, Windows) are self-contained, while others require curl, wget, or python3 for plugin components.

Compare cosmotop with