1---
2title: AI SDK DevTools
3description: Debug AI SDK calls by inspecting captured runs and steps.
4---
5 
6# AI SDK DevTools
7 
8## Why Use DevTools
9 
10DevTools captures all AI SDK calls (`generateText`, `streamText`, `ToolLoopAgent`) to a local JSON file. This lets you inspect LLM requests, responses, tool calls, and multi-step interactions without manually logging.
11 
12## Setup
13 
14Requires AI SDK 6. Install `@ai-sdk/devtools` using your project's package manager.
15 
16Wrap your model with the middleware:
17 
18```ts
19import { wrapLanguageModel, gateway } from 'ai';
20import { devToolsMiddleware } from '@ai-sdk/devtools';
21 
22const model = wrapLanguageModel({
23  model: gateway('anthropic/claude-sonnet-4.5'),
24  middleware: devToolsMiddleware(),
25});
26```
27 
28## Viewing Captured Data
29 
30All runs and steps are saved to:
31 
32```
33.devtools/generations.json
34```
35 
36Read this file directly to inspect captured data:
37 
38```bash
39cat .devtools/generations.json | jq
40```
41 
42Or launch the web UI:
43 
44```bash
45npx @ai-sdk/devtools
46# Open http://localhost:4983
47```
48 
49## Data Structure
50 
51- **Run**: A complete multi-step interaction grouped by initial prompt
52- **Step**: A single LLM call within a run (includes input, output, tool calls, token usage)
53