# Crumbs

**Stop pasting stack traces. Let your agent read them.**

Passive watchers record every request, log line, exception and query of a running Flutter app. Read them from the CLI or let your AI agent query them. Debug builds only.

## Watch. Redact. Read.

Debugging a running app means print statements, log files and proxies that each tell a slice of the story. Crumbs puts it all in one buffer.

### Passive watchers

Logs, exceptions, dumps and frame timings, plus Magic adapters for HTTP, models, cache, events, gates and queries.

[Learn more about Passive watchers](https://anilcancakir.com/crumbs/docs/watchers/index.md)

### Ring buffers

Every record lands in a bounded buffer, so a long session never grows without limit.

[Learn more about Ring buffers](https://anilcancakir.com/crumbs/docs/getting-started/buffers.md)

### Credential redaction

Authorization headers and password or token keys read `********` before a record is buffered.

[Learn more about Credential redaction](https://anilcancakir.com/crumbs/docs/getting-started/redaction.md)

### File sink

A rotating JSONL timeline of redacted records that you read from the CLI or an agent.

[Learn more about File sink](https://anilcancakir.com/crumbs/docs/getting-started/file-sink.md)

### Ten MCP tools

Your agent reads requests, exceptions, logs and queries itself, with no pasted stack traces.

[Learn more about Ten MCP tools](https://anilcancakir.com/crumbs/docs/mcp/overview.md)

### Cursors and filters

`since` and a cursor let an agent ask only for what is new.

[Learn more about Cursors and filters](https://anilcancakir.com/crumbs/docs/mcp/cursor-and-filters.md)

## Your agent speaks Crumbs.

The Crumbs skill teaches your coding assistant which watcher answers which question before it reads a single record. One command wires it up.

```bash
npx skills add anilcancakir/ai --skill crumbs
```

[other editors](https://github.com/anilcancakir/ai)

## And reads the app itself.

Skills teach the questions. The stdio MCP server gives your agent ten tools over the running app's records.

```bash
claude mcp add crumbs -- dart run crumbs mcp:serve
```

## Start building in seconds

```bash
flutter pub add crumbs
```

Or add to `pubspec.yaml`:

```yaml
dependencies:
  crumbs: ^0.0.13
```

Or give your AI agent this prompt:

```text
Read https://anilcancakir.com/crumbs/docs/llms.txt and install the Crumbs package in this project.
```

## Docs

### Getting Started

- [Getting Started](https://anilcancakir.com/crumbs/docs/getting-started/index.md)
- [Installation](https://anilcancakir.com/crumbs/docs/getting-started/installation.md)
- [Quickstart](https://anilcancakir.com/crumbs/docs/getting-started/quickstart.md)
- [Buffers](https://anilcancakir.com/crumbs/docs/getting-started/buffers.md)
- [File sink](https://anilcancakir.com/crumbs/docs/getting-started/file-sink.md)
- [Redaction](https://anilcancakir.com/crumbs/docs/getting-started/redaction.md)

### Watchers

- [Watchers](https://anilcancakir.com/crumbs/docs/watchers/index.md)
- [FramePerfWatcher](https://anilcancakir.com/crumbs/docs/watchers/frames.md)

### MCP

- [MCP Overview](https://anilcancakir.com/crumbs/docs/mcp/overview.md)
- [MCP Setup](https://anilcancakir.com/crumbs/docs/mcp/setup.md)
- [MCP Tool Reference](https://anilcancakir.com/crumbs/docs/mcp/tool-reference.md)
- [Cursor and filters](https://anilcancakir.com/crumbs/docs/mcp/cursor-and-filters.md)