# Crumbs documentation

> Crumbs watches a running Flutter app for requests, logs, exceptions and queries, redacts credentials and lets an AI agent read them.

## Getting Started

- [Getting Started](https://anilcancakir.com/crumbs/docs/getting-started/index.md): What crumbs captures, what it needs, and where to start: installation, the quickstart, and the host features for redaction, the file sink and buffers.
- [Installation](https://anilcancakir.com/crumbs/docs/getting-started/installation.md): Add crumbs to a Flutter app, install it behind a call-site guard, register it with dowel, and optionally write the MCP entry for your AI client.
- [Quickstart](https://anilcancakir.com/crumbs/docs/getting-started/quickstart.md): Take a fresh Flutter project from zero to an AI agent reading the app's logs, HTTP traffic and exceptions through the crumbs_* MCP tools.
- [Buffers](https://anilcancakir.com/crumbs/docs/getting-started/buffers.md): How CrumbsStore holds records: one in-memory ring buffer per record kind, their capacities, the atUs clock, and what limit and minLevel return.
- [File sink](https://anilcancakir.com/crumbs/docs/getting-started/file-sink.md): CrumbsFileSink keeps a timeline on disk that outlives the in-memory buffers: a rotating set of JSONL files of the redacted log, event and exception records…
- [Redaction](https://anilcancakir.com/crumbs/docs/getting-started/redaction.md): How crumbs keeps secrets out of the buffers it serves to AI agents and writes to disk: credential lists for HTTP records, and a host-supplied text redactor for…

## Watchers

- [Watchers](https://anilcancakir.com/crumbs/docs/watchers/index.md): Every watcher and HTTP adapter that feeds crumbs: what each captures, how it is installed, and the guard and chaining rules they share.
- [FramePerfWatcher](https://anilcancakir.com/crumbs/docs/watchers/frames.md): FramePerfWatcher records the build, raster and vsync cost of every drawn frame, with optional per-widget attribution, and proves the engine is still rendering.

## MCP

- [MCP Overview](https://anilcancakir.com/crumbs/docs/mcp/overview.md): How the crumbs_* MCP tools reach the running app: crumbs contributes them to the dowel MCP server, and each one reads an ext.crumbs.* VM Service extension.
- [MCP Setup](https://anilcancakir.com/crumbs/docs/mcp/setup.md): Make the crumbs_* tools appear in Claude Code, Cursor or any other MCP client: install crumbs, write the dowel entry in .mcp.json, reconnect, and optionally…
- [MCP Tool Reference](https://anilcancakir.com/crumbs/docs/mcp/tool-reference.md): Every crumbs_* MCP tool: what it reads, its input schema, its output shape and the ext.crumbs.* extension it calls in the running app.
- [Cursor and filters](https://anilcancakir.com/crumbs/docs/mcp/cursor-and-filters.md): Follow the log and event buffers without re-reading them or skipping a record: the filters and the cursor of ext.crumbs.console and ext.crumbs.events, the…

## Optional

- [Crumbs](https://anilcancakir.com/crumbs): the package landing page
- [Full documentation](https://anilcancakir.com/crumbs/docs/llms-full.txt): every page in one file