How do I install the Tanstack AI Migration skill?

Run npx skillmds@latest add tanstack/tanstack-ai-migration in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tanstack AI Migration safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tanstack AI Migration?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tanstack AI Migration free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tanstack AI Migration?

TanStack (@tanstack) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tanstack AI Migration by tanstack — Agent Skill

Name: Tanstack AI Migration
Author: TanStack

Tanstack AI Migration

Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or move it off a deprecated TanStack AI API. Use when someone asks whether to switch AI libraries, when code mixes streamText, generateText, generateObject, createOpenAI, or @ai-sdk/* with TanStack AI, when an upgrade breaks, or when someone hits a renamed option, a deprecated -ui package, or an old adapter shape. Triggers on "migrate", "switch from Vercel AI SDK", "ai-sdk", "streamText", "upgrade TanStack AI", "deprecated", "breaking change", "codemod".

TanStack 8962fde 2.6 KB Updated Sep 17, 2026

File contents

Migrating to TanStack AI

Two different jobs. Pick the one that matches the code in front of you.

Coming from another SDK

The name-by-name mapping lives in the docs, and it is longer than any summary that fits here:

https://tanstack.com/ai/latest/docs/migration/migration-from-vercel-ai

The shape of the change:

streamText and generateText become one chat() call with a streaming option.
createOpenAI(...) becomes a tree-shakeable adapter, such as openaiText() from @tanstack/ai-openai.
onFinish and friends become middleware hooks.
Manual SSE wiring becomes the built-in response helpers.
generateObject becomes structured outputs on chat().

Read the guide, then load the target API's own skill with npx @tanstack/intent@latest load @tanstack/ai#ai-core. Do not port from memory: a half-remembered mapping produces code that type-checks in neither SDK.

Upgrading TanStack AI itself

Start with the version the app has, and the current release:

node -p "require('@tanstack/ai/package.json').version"
npm view @tanstack/ai version

Then read the guides for what changed:

Deprecated APIs keep working, so upgrade in steps rather than rewriting everything at once.

Codemods

Some renames have a jscodeshift transform. Run it straight from the repo, and preview first with --dry --print:

npx jscodeshift \
  -t https://raw.githubusercontent.com/TanStack/ai/main/codemods/ag-ui-compliance/transform.ts \
  --dry --print src/

Each guide names the codemod that covers it, and what the codemod cannot reach. Server-side rewrites are usually manual.

After the port

Run the project's type checker. Most errors after a migration come from an API that was remembered rather than read, so check the failing name against node_modules/@tanstack/ai/src/ before changing it again.

---name: tanstack-ai-migrationdescription: Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or move it off a deprecated TanStack AI API. Use when someone asks whether to switch AI libraries, when code mixes streamText, generateText, generateObject, createOpenAI, or @ai-sdk/* with TanStack AI, when an upgrade breaks, or when someone hits a renamed option, a deprecated -ui package, or an old adapter shape. Triggers on "migrate", "switch from Vercel AI SDK", "ai-sdk", "streamText", "upgrade TanStack AI", "deprecated", "breaking change", "codemod".---# Migrating to TanStack AITwo different jobs. Pick the one that matches the code in front of you.## Coming from another SDKThe name-by-name mapping lives in the docs, and it is longer than any summarythat fits here:https://tanstack.com/ai/latest/docs/migration/migration-from-vercel-aiThe shape of the change:- `streamText` and `generateText` become one `chat()` call with a streaming option.- `createOpenAI(...)` becomes a tree-shakeable adapter, such as `openaiText()` from `@tanstack/ai-openai`.- `onFinish` and friends become middleware hooks.- Manual SSE wiring becomes the built-in response helpers.- `generateObject` becomes structured outputs on `chat()`.Read the guide, then load the target API's own skill with`npx @tanstack/intent@latest load @tanstack/ai#ai-core`. Do not port from memory: a half-remembered mapping producescode that type-checks in neither SDK.## Upgrading TanStack AI itselfStart with the version the app has, and the current release:```bashnode -p "require('@tanstack/ai/package.json').version"npm view @tanstack/ai version```Then read the guides for what changed:- https://tanstack.com/ai/latest/docs/migration/migration- https://tanstack.com/ai/latest/docs/migration/ag-ui-compliance- https://tanstack.com/ai/latest/docs/migration/sampling-options-to-model-options- https://tanstack.com/ai/latest/docs/migration/create-uiDeprecated APIs keep working, so upgrade in steps rather than rewritingeverything at once.## CodemodsSome renames have a jscodeshift transform. Run it straight from the repo, andpreview first with `--dry --print`:```bashnpx jscodeshift \ -t https://raw.githubusercontent.com/TanStack/ai/main/codemods/ag-ui-compliance/transform.ts \ --dry --print src/```Each guide names the codemod that covers it, and what the codemod cannot reach.Server-side rewrites are usually manual.## After the portRun the project's type checker. Most errors after a migration come from an APIthat was remembered rather than read, so check the failing name against`node_modules/@tanstack/ai/src/` before changing it again.

Frequently asked questions