Get Kilometers monitoring set up in under 5 minutes. This guide will walk you through installation, configuration, and your first monitoring session.
Before you begin, make sure you have:
Install the Kilometers CLI with a single command. Our installer will automatically detect your system and install the appropriate version.
curl -sSL https://get.kilometers.ai | sh
km --version
You should see the version number if installation was successful.
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.
km init --tool cursor
This will create a configuration file and set up monitoring for Cursor.
Add the following to your Cursor settings (Cmd/Ctrl + Shift + P → "Preferences: Open Settings (JSON)"):
{ "mcpServers": { "kilometers": { "command": "km", "args": ["--monitor", "--cursor"] } } }
Configuration Complete!
Restart Cursor for the changes to take effect.
Now let's start monitoring and see your first AI request data.
km start
Open Cursor and make any AI request (ask a question, generate code, etc.). Kilometers will automatically detect and track the request.
km dashboard
This will open your monitoring dashboard in the browser where you can see all your AI activity.
Congratulations! You now have Kilometers monitoring your AI agents. Here's what to explore next:
Get notified when costs spike or unusual activity is detected.
Integrate monitoring data into your existing tools and workflows.
Add team members and manage permissions for collaborative monitoring.
Customize monitoring rules, filters, and advanced settings.