Getting Started

aisdk-dt lets your coding agent inspect AI SDK DevTools generations.json files without loading huge prompts, raw responses, or stream chunks into context.

1. Enable AI SDK DevTools

aisdk-dt depends on the generations.json file created by AI SDK DevTools.

If you have not set this up yet, use the official guide first:

• https://ai-sdk.dev/docs/ai-sdk-core/devtools

After enabling DevTools, run your app and confirm .devtools/generations.json exists (or identify your configured output path).

2. Install The CLI

Install the aisdk-dt binary globally:

With pnpm:

pnpm add -g aisdk-dt

With npm:

npm install -g aisdk-dt

Or run it without installing:

With pnpm:

pnpx aisdk-dt runs --file .devtools/generations.json

With npm:

npx aisdk-dt runs --file .devtools/generations.json

Or install it locally as a dev dependency:

With pnpm:

pnpm add -D aisdk-dt

With npm:

npm install -D aisdk-dt

aisdk-dt requires Node.js 20 or newer.

3. Install The Agent Skill

Install the bundled skill with skills.sh:

npx skills add tom-auger/aisdk-dt --skill aisdk-dt-inspector

Then call the skill by name when you want your agent to inspect DevTools data:

Use $aisdk-dt-inspector to inspect .devtools/generations.json and summarize the failed run.

The skill tells agents to prefer bounded semantic commands before raw payloads.

4. Point It At A DevTools File

From the app that produced the DevTools file, aisdk-dt defaults to:

.devtools/generations.json

From another directory, pass an explicit path:

aisdk-dt runs --file /absolute/path/to/generations.json

5. First Agent Workflow

Start with recent runs:

aisdk-dt runs --limit 10 --file <path>

Inspect the prompt transcript:

aisdk-dt messages <runId> --limit 6 --max-chars 500 --file <path>

List steps for the run:

aisdk-dt steps <runId> --file <path>

Inspect a step output:

aisdk-dt output <stepId> --max-chars 800 --file <path>

6. When To Use Raw Payloads

Use raw payloads when the bounded message, output, tool, and usage commands do not answer the question.

aisdk-dt raw <stepId> --request --json-path 'model' --file <path>
aisdk-dt raw <stepId> --response --json-path 'content[0]' --max-chars 800 --file <path>

Prefer --json-path and --max-chars before --full.

Update The CLI

If you installed aisdk-dt globally, update it with the same package manager:

With pnpm:

pnpm add -g aisdk-dt@latest

With npm:

npm install -g aisdk-dt@latest

If you installed it locally in a project:

With pnpm:

pnpm update aisdk-dt

With npm:

npm update aisdk-dt

If you use npx or pnpx, you usually do not need to update anything manually; they resolve the package when run.

Next Steps

• Agent Skill
• Workflows
• CLI Reference
• Safe Inspection
• Example Chatbot (repo)