# Tiltmeter

> Tiltmeter is an open-source (MIT) early-warning system for the third-party APIs that AI agents depend on. It learns the shape of JSON responses from real traffic, flags breaking changes such as removed fields, type changes and new nulls, warns you, your CI and your agents over MCP, and `tiltmeter fix` hands the drift to an agent that adapts your code and opens a pull request.

Install with `pip install tiltmeter` (Python 3.12 or later). It runs locally with one SQLite file and no account. No API spec is needed: the contract is learned from responses.

## Docs

- [Getting started](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/getting-started.md): install, record a baseline and catch a breaking change against a fake API in about five minutes
- [Configuration](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/configuration.md): every option in `tiltmeter.yaml`
- [Agents and MCP](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/agents.md): the MCP server for Claude Code, Cursor, Claude Desktop, LangChain and other clients
- [Fixing code](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/fix.md): how `tiltmeter fix` adapts code in a worktree and opens a pull request
- [CI](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/ci.md): exit codes and jobs for GitHub Actions, GitLab CI and cron
- [How it works](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/how-it-works.md): shapes, baselines and what counts as drift
- [FAQ](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/faq.md)
- [Provider notices](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/notices.md): providers publish signed change notices; customers get a pull request per change that affects their code, or follow a provider's OpenAPI spec directly
- [API change notices, v1](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/docs/notice-spec.md): the open notice and feed format, signatures and the rules for readers, with JSON Schemas at https://tiltmeter.dev/schemas/api-change-notice/v1.json and https://tiltmeter.dev/schemas/api-change-feed/v1.json

## For agents

- [Full reference](https://tiltmeter.dev/llms-full.txt): setup steps, commands, MCP tools, drift types and exit codes in one file
- [Migration tracker](https://tiltmeter.dev/migrations/): the pull requests Tiltmeter opened in public repositories to fix code using API changes, grouped by provider, with their status on GitHub; the data is at https://tiltmeter.dev/migrations/status.json. Tiltmeter drafted these change notices from public documentation; no provider signed or endorsed them

## Optional

- [Source code](https://github.com/tiltmeter-dev/tiltmeter)
- [GitHub Action](https://github.com/tiltmeter-dev/tiltmeter-action)
- [PyPI package](https://pypi.org/project/tiltmeter/)
- [Security policy](https://raw.githubusercontent.com/tiltmeter-dev/tiltmeter/main/SECURITY.md)