README

Make your AI agents self-healing



Agents that fix themselves, at scale.


  
  
  
  
  
  
  



  Website  ·  
  Docs  ·  
  Changelog  ·  
  Slack  ·  
  X



  
    
    
    
  


 🌈 Why Latitude?

Latitude finds where your agent fails and gets it fixed.
- Observe: one line of telemetry captures every trace: multi-turn sessions, tool calls, and full execution paths. _(traces, sessions, tool-call observability, OpenTelemetry ingest)_
- Understand: failing traces are auto-grouped into tracked signals with status, size, and trend, so you see what's breaking and how often. _(signals, flaggers, behaviours, semantic search, annotations)_
- Fix: Latitude dispatches your coding agents (Claude Code, Cursor) with the full context, sample traces, and a deep link. It writes the smallest correct fix and opens a PR. _(Agent Dispatch, MCP server, Linear & webhook dispatch)_
- Verify: fixes are replayed against the real failing traces, so fixed failures don't come back. _(regression datasets, monitors, alerts)_

Everything you can do in the UI is also available from your coding agent via the MCP server and the CLI.

 📚 Table of contents

- Quick start
- Integrations
- With Claude Code
- Development
- Self-host
- Community
- Contributing
- License
- Links

 ⚡ Quick start

You can use Latitude for free, including 20K credits/month, 30-day data retention, and unlimited seats.

Sign up at latitude.so and grab your API key and project slug.

 Recommended: ask your coding agent

Paste this prompt into Claude Code, Cursor, Windsurf, Codex, OpenCode, or another coding agent:

text
Install the latitude-setup skill from github.com/latitude-dev/skills, and use it to add Latitude tracing to this app following best practices.


 Manual TypeScript setup

bash
npm install @latitude-data/telemetry


This example uses OpenAI; replace it with the LLM SDK your app already imports.

ts
import { Latitude } from "@latitude-data/telemetry";
import OpenAI from "openai";

const latitude = new Latitude({
  apiKey: process.env.LATITUDE_API_KEY!,
  project: process.env.LATITUDE_PROJECT_SLUG!,
  instrumentations: { openai: OpenAI },
});

const client = new OpenAI();

await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Hello" }],
});

await latitude.shutdown();


Every supported LLM call now shows up as a trace in Latitude. Use capture() at request, conversation, or agent boundaries when you want to add user IDs, session IDs, tags, or metadata.

Python and any OpenTelemetry-compatible runtime are also supported. Full setup, provider guides, and OTel passthrough are in the Start tracing guide.

 🔌 Integrations

Latitude is provider-agnostic. Telemetry works out of the box with most model providers and frameworks (OpenAI, Anthropic, Bedrock, Vercel AI SDK, LangChain, and more), plus any OTEL-compatible application.

See the full integration list for setup instruct