Metadata-Version: 2.4
Name: rewind-llm
Version: 0.4.0
Summary: Record-replay debugger for AI agent runs
Author: Praash
License-Expression: MIT
Project-URL: Homepage, https://github.com/praashh/rewind
Project-URL: Repository, https://github.com/praashh/rewind
Project-URL: Issues, https://github.com/praashh/rewind/issues
Keywords: ai,agents,debugging,record-replay,trace
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.20; extra == "anthropic"
Provides-Extra: openai
Requires-Dist: openai>=1.0; extra == "openai"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Dynamic: license-file

# rewind

[![PyPI](https://img.shields.io/pypi/v/rewind-llm)](https://pypi.org/project/rewind-llm/)
[![Python](https://img.shields.io/pypi/pyversions/rewind-llm)](https://pypi.org/project/rewind-llm/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Record-replay debugger for AI agent runs.

An agent only touches the outside world through a narrow boundary: **model calls in, tool calls out.** `rewind` captures everything crossing that boundary, then replays it exactly — or branches from any step to explore alternate trajectories.

## Installation

```bash
pip install rewind-llm
```

## Quickstart

### CLI proxy

```bash
# Record a session
rewind record -- claude "fix the bug"

# Replay it
rewind replay traces/anthropic_20260101_120000.jsonl -- claude "fix the bug"
```

## CLI commands

```bash
rewind ls                                           # List traces
rewind show <trace.jsonl>                           # Pretty-print
rewind diff <a.jsonl> <b.jsonl> [--html out.html]   # Diff traces
rewind branch <trace> --at N --edit|--inject|--live  # Branch
rewind record -- <cmd>                              # Record via proxy
rewind replay <trace> -- <cmd>                      # Replay via proxy
```

## Development

```bash
pip install -e ".[dev]"
python -m pytest tests/ -v
```

## License

MIT
