@ai-sdk/devtools

AI SDK DevTools

A local development tool for debugging and inspecting AI SDK applications. View LLM requests, responses, tool calls, and multi-step interactions in a web-based UI.

Note: This package is experimental and intended for local development only. Do not use in production environments.

Installation

npm install @ai-sdk/devtools
# or
pnpm add @ai-sdk/devtools

Requirements

• AI SDK v6 beta (ai@^6.0.0-beta.0)
• Node.js compatible runtime

Usage

1. Add the middleware to your model

import { wrapLanguageModel } from 'ai';
import { devToolsMiddleware } from '@ai-sdk/devtools';

const model = wrapLanguageModel({
  middleware: devToolsMiddleware(),
  model: yourModel,
});

2. Run the viewer

npx @ai-sdk/devtools

Open http://localhost:4983 to view your AI SDK interactions.

How it works

The middleware intercepts all generateText and streamText calls, capturing:

• Input parameters and prompts
• Output content and tool calls
• Token usage and timing
• Raw provider request/response data

Data is stored locally in a JSON file (.devtools/generations.json) and served through a web UI.

Data flow

AI SDK call → devToolsMiddleware → JSON file → Hono API → React UI

Key concepts

• Run: A complete multi-step AI interaction, grouped by initial prompt
• Step: A single LLM call within a run

Development

pnpm install
pnpm dev        # Start dev server at http://localhost:5173

License

MIT