Terminal
Terminal/Skill
Helps move an app from the Vercel AI SDK or raw provider SDKs to TanStack AI, or off deprecated TanStack AI APIs.
By TanStack
Works with
npx skills add tanstack/ai --skill tanstack-ai-migrationTwo different jobs. Pick the one that matches the code in front of you.
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.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.
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.
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.
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.