Getting Started
5 min read

Quick Start Guide

Get Kilometers monitoring set up in under 5 minutes. This guide will walk you through installation, configuration, and your first monitoring session.

Prerequisites

Before you begin, make sure you have:

  • An AI tool that supports MCP (Cursor, Claude Desktop, or VS Code with AI extensions)
  • macOS, Linux, or Windows with WSL2
  • Node.js 18+ (for some integrations)

Installation

Install the Kilometers CLI with a single command. Our installer will automatically detect your system and install the appropriate version.

Install Kilometers

TERMINAL
curl -sSL https://get.kilometers.ai | sh

Verify Installation

TERMINAL
km --version

You should see the version number if installation was successful.

Configuration

Now let's configure Kilometers to work with your AI tool. We'll use Cursor as an example, but the process is similar for other tools.

Initialize Kilometers

TERMINAL
km init --tool cursor

This will create a configuration file and set up monitoring for Cursor.

Update Cursor Configuration

Add the following to your Cursor settings (Cmd/Ctrl + Shift + P → "Preferences: Open Settings (JSON)"):

CURSOR CONFIG
{
  "mcpServers": {
    "kilometers": {
      "command": "km",
      "args": ["--monitor", "--cursor"]
    }
  }
}

Configuration Complete!

Restart Cursor for the changes to take effect.

First Monitoring Session

Now let's start monitoring and see your first AI request data.

Start Monitoring

TERMINAL
km start

Make an AI Request

Open Cursor and make any AI request (ask a question, generate code, etc.). Kilometers will automatically detect and track the request.

View Your Dashboard

TERMINAL
km dashboard

This will open your monitoring dashboard in the browser where you can see all your AI activity.

Next Steps

Congratulations! You now have Kilometers monitoring your AI agents. Here's what to explore next:

Set Up Alerts

Get notified when costs spike or unusual activity is detected.

API Integration

Integrate monitoring data into your existing tools and workflows.

Team Setup

Add team members and manage permissions for collaborative monitoring.

Advanced Config

Customize monitoring rules, filters, and advanced settings.