# Update

> Update assistant-ui and AI SDK to latest versions. Detects current versions, identifies breaking changes, and executes migrations.

- Skill: `akarachen/update` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add akarachen/update`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akarachen/update/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: akarachen (https://skillmd.com/u/akarachen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/akarachen/update

---


# assistant-ui Update

**Always verifies against npm ground truth and GitHub commits.**

## References

- [./references/ai-sdk-v6.md](./references/ai-sdk-v6.md) -- AI SDK v4/v5 → v6 migration (complete guide)
- [./references/assistant-ui.md](./references/assistant-ui.md) -- assistant-ui version migrations
- [./references/breaking-changes.md](./references/breaking-changes.md) -- Quick reference table

## Phase 1: Detect Versions

### Get Ground Truth

```bash
# Installed versions
npm ls @assistant-ui/react @assistant-ui/react-ai-sdk ai @ai-sdk/react 2>/dev/null

# Latest from npm
npm view @assistant-ui/react version
npm view @assistant-ui/react-ai-sdk version
npm view ai version
```

### Version Analysis

| Package | Check For |
|---------|-----------|
| `ai` | < 6.0.0 → needs AI SDK v6 migration |
| `@assistant-ui/react` | < 0.12.0 → needs unified state API migration |
| `@assistant-ui/react` | < 0.11.0 → needs runtime migration |
| `@assistant-ui/react` | < 0.10.0 → needs ESM migration |
| `@assistant-ui/react` | < 0.8.0 → needs UI split migration |
| `@assistant-ui/react-ai-sdk` | < 1.0.0 → needs AI SDK v6 first |

## Phase 2: Route to Migration

```
AI SDK < 6.0.0?
├─ Yes → See ./references/ai-sdk-v6.md
└─ No
   └─ assistant-ui outdated?
      ├─ Yes → See ./references/assistant-ui.md
      └─ No → Already up to date
```

### Migration Order

1. **AI SDK first** (if < 6.0.0) - Required for @assistant-ui/react-ai-sdk >= 1.0
2. **assistant-ui second** - Apply breaking changes for version jump
3. **Verify** - Type check, build, test

## Phase 3: Execute

### Update Packages

```bash
# pnpm
pnpm add @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest

# npm
npm install @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest
```

### Apply Migrations

Based on version jump, apply relevant migrations from references.

### Verify

```bash
npx tsc --noEmit  # Type check
pnpm build        # Build check
```

## Troubleshooting

**"Peer dependency conflict"**
- Update all packages together
- Check version compatibility in [./references/breaking-changes.md](./references/breaking-changes.md)

**Type errors after upgrade**
- Consult breaking changes reference
- Check specific migration guide

**Runtime errors**
- Verify API patterns match new version
- Check for renamed/moved APIs