Le UI SDK est une bibliothèque de comportements destinée aux agents de programmation. D'après le README officiel du dépôt et la documentation, la navigation au clavier, le focus, la sélection, la fermeture ou le renvoi, les calques, le glisser-déposer et les attributs ARIA nécessaires vivent dans le paquet TypeScript indépendant du framework @ui-sdk/core. Les adaptateurs les rendent ensuite avec @ui-sdk/react, @ui-sdk/vue, @ui-sdk/svelte, @ui-sdk/solid et @ui-sdk/web. Ce n'est pas une API de modèle, et le SDK ne décide pas de l'apparence : les composants fournis comme les parties que vous composez avec definePrimitive n'ont pas de styles, pas de provider et pas de portail (portal).
@vercel l'a annoncé le 12 novembre 2026 à 18:41 UTC (13 novembre 02:41, Asia/Shanghai) avec le message « Introducing the UI SDK. » Dans la même fenêtre, @shadcn a expliqué le parti pris de conception, et @rauchg l'a comparé à « the x86 instruction set for agents ». La documentation est sur ui-sdk.dev, le code source sur vercel-labs/ui. Sur npm, @ui-sdk/core, @ui-sdk/react et les autres paquets de framework publient actuellement 0.1.0-beta.1, sous licence Apache-2.0.
Le 13 novembre 2026 (Asia/Shanghai, UTC+8), nous avons exécuté le SDK sur une machine Debian 13 x86_64, avec Node.js v24.22.2, npm 11.19.1 et React 19.3.1. npm install @ui-sdk/react @ui-sdk/core a bien installé 0.1.0-beta.1. Nous avons recopié l'exemple officiel search-field du README dans une application Vite + React minimale, et npm run build (tsc -b && vite build) a réussi. Nous avons ensuite lancé npx skills add vercel-labs/ui --skill ui-sdk, puis demandé à Claude Code 2.1.319 et à Codex CLI 0.167.0, via l'API de ce site et le skill, de générer chacun un composant d'évaluation à cinq étoiles. Nous n'avons pas lancé de tâche d'agent dans Cursor cette fois. Les versions, commandes, durées et sorties ci-dessous viennent de cette exécution.
L'essentiel
| Question | Réponse |
|---|---|
| C'est quoi le UI SDK ? | Une bibliothèque de comportements pour les agents : les interactions et l'ARIA vivent dans @ui-sdk/core, les adaptateurs de framework les rendent. |
| Version actuelle | npm 0.1.0-beta.1 (publiée le 12 novembre 2026, Apache-2.0). L'adaptateur React a une peer dependency vers React 19+. |
| Comment l'installer ? | Pour React : npm install @ui-sdk/react @ui-sdk/core. Pour les autres frameworks, remplacez @ui-sdk/react par le paquet correspondant. |
| Comment le donner à un agent ? | Exécutez npx skills add vercel-labs/ui --skill ui-sdk, puis mettez à jour AGENTS.md comme le décrivent les docs, en pointant vers la documentation livrée avec le paquet, par exemple node_modules/@ui-sdk/react/docs/llms.txt. |
| Comment écrire son propre composant ? | Composez des behaviors avec definePrimitive, puis rendez-les avec createParts dans votre framework. Les guides officiels incluent search-field, un bouton mute et une barre de réactions. |
| Et les composants déjà fournis ? | @ui-sdk/react propose aussi des composants prêts à l'emploi comme Select, Dialog, Tabs et Rating. Ils n'ont pas de styles, ni de provider, ni de portail. |
| Ce que nous avons exécuté | L'installation a pris environ 0,8 s. La compilation de l'exemple officiel search-field a réussi en environ 0,9 s. L'ajout du skill a pris environ 6,7 s. Claude Code a généré une évaluation en environ 65 s, Codex en environ 71 s ; les deux compilations ont réussi, et les 2 tests de Codex sont passés. |
| Point d'attention | C'est une beta, soumise aux conditions public beta de Vercel. La documentation officielle indique que les API peuvent encore changer. |
Qu'est-ce que le UI SDK
D'après la documentation officielle et le README, le UI SDK n'est pas une nouvelle bibliothèque de composants déjà stylés. Il formalise « comment une interface se comporte » sous forme de behaviors composables, puis laisse une personne ou un agent assembler des composants. Le même primitive peut être rendu en React, Vue, Svelte, Solid et Web Components.
D'après @shadcn, les agents deviennent à la fois les constructeurs et les utilisateurs des interfaces, donc l'abstraction doit se situer au niveau des comportements. Un Select, par exemple, a un calque, une logique de sélection, une navigation au clavier et une gestion du focus, des pièces que l'on retrouve dans beaucoup d'autres composants. Ces pièces ont été séparées, testées et rendues réutilisables, et le comportement reste le même quel que soit le framework, le moteur de rendu ou le harness. L'objectif, écrit-il, est de donner aux agents les pièces pour générer l'interface dont vous avez besoin, y compris des interfaces « we haven't thought of yet ».
D'après @rauchg, le UI SDK est « like the x86 instruction set for agents » pour construire spontanément de nouveaux composants d'interface.
La documentation officielle propose deux chemins en parallèle :
- Composer vous-même les behaviors : définissez les parties, l'état et les actions avec
definePrimitive, puis rendez-les aveccreateParts. Le guide du dépôt est un search-field ; la documentation inclut aussi un bouton mute et la barre de réactions dans Build a Component. - Utiliser les composants fournis :
@ui-sdk/reactexporte chaque composant depuis sa propre entrée, par exemple@ui-sdk/react/button,@ui-sdk/react/dialog,@ui-sdk/react/tabset@ui-sdk/react/rating. Les docs précisent qu'il n'y a pas d'import racine depuis@ui-sdk/react. Les composants n'ont pas de styles, pas de dépendances, pas de provider et pas de portail ; vous ajoutez le CSS ou Tailwind vous-même.
Pour qu'un agent pilote une page déjà rendue, vous pouvez appeler createAgent() afin de lire l'état des composants et d'invoquer des actions. Cette API est documentée dans Agents. La documentation Agents officielle inclut aussi une comparaison project-settings (médiane de trois exécutions par approche, toutes avec Sonnet via Claude Code, toutes terminées) : les outils du navigateur ont fait 16 appels d'outils et pris 41 secondes ; le pont agent de ui-sdk a fait 5 appels d'outils et pris 16 secondes. Ces chiffres viennent de l'expérience officielle, pas d'une nouvelle mesure sur notre machine.
Le UI SDK est en beta. Le site de documentation indique : « UI SDK is in beta, so some APIs may still change. » L'usage est soumis au Vercel Public Beta Agreement. Avant la disponibilité générale, les API, la documentation et les behaviors peuvent encore évoluer.
Calendrier de publication et discussions
L'heure officielle de lancement est celle de l'annonce @vercel : 2026-11-12 18:41:04 UTC, soit 2026-11-13 02:41:04 en Asia/Shanghai. Sur npm, @ui-sdk/react@0.1.0-beta.1 a été publié le 2026-11-12 17:09:05 UTC (01:09 en Asia/Shanghai), et @ui-sdk/core@0.1.0-beta.1 à 17:12:06 UTC (01:12).
D'après les données publiques de X, au 13 novembre 2026 à 04:23 Asia/Shanghai :
- L'annonce @vercel : 1 420 j'aime, 93 978 impressions, 892 signets
- Le texte de @shadcn : 1 519 j'aime, 45 079 impressions, 1 064 signets
- Le commentaire de @rauchg : 221 j'aime, 10 762 impressions
Si vous suivez déjà d'autres outils agent de Vercel, vous pouvez aussi comparer Comment utiliser Vercel agent-desktop et Comment utiliser Cursor Live Apps.
Installer 0.1.0-beta.1 dans un projet React 19
La documentation d'installation React officielle exige React 19 et React DOM 19 ou plus récent. Nous avons créé une application minimale avec create-vite@9.3.4 et le modèle react-ts, qui livrait react@19.3.1 / react-dom@19.3.1 et @types/react@19.3.0 (les docs demandent aussi @types/react 19.2.10 ou plus récent pour TypeScript).
npm install @ui-sdk/react @ui-sdk/core
Nous avons lancé cette commande à 04:20 le 13 novembre 2026, Asia/Shanghai. npm a affiché added 2 packages, and audited 31 packages in 797ms. La durée réelle a été d'environ 0,86 seconde, code de sortie 0. npm ls a montré :
@ui-sdk/core@0.1.0-beta.1
@ui-sdk/react@0.1.0-beta.1
react@19.3.1
react-dom@19.3.1
Les deux paquets SDK sont sous licence Apache-2.0. Les peer dependencies de @ui-sdk/react sont react / react-dom >=19 et @ui-sdk/core ^0.1.0-beta.1. Pour les autres frameworks, le README officiel indique de remplacer @ui-sdk/react par @ui-sdk/vue, @ui-sdk/svelte, @ui-sdk/solid ou @ui-sdk/web, tout en installant aussi @ui-sdk/core.
Construire l'exemple officiel search-field
Le guide du README officiel est un champ de recherche avec un bouton Clear : ce bouton n'apparaît que lorsque le champ contient du texte, et l'activer vide le champ puis remet le focus dans l'entrée. Nous avons recopié le primitive et le rendu React dans src/lib/search-field.ts et src/components/Search.tsx, et nous avons aussi rendu le Toggle du guide officiel First Component dans App.tsx.
import { createFocusRecovery, definePrimitive } from "@ui-sdk/core"
const searchField = definePrimitive({
name: "search-field",
state: () => ({ value: "" }),
api: (context) => ({
set: (value: string) => context.store.set({ value }),
recovery: createFocusRecovery({ fallback: () => context.element("input") }),
}),
slots: (slot) => ({
input: slot({
attrs: (state) => ({ value: state.value }),
on: {
input: (event, { api }) =>
api.set((event.target as HTMLInputElement).value),
},
}),
clear: slot({
present: (state) => state.value !== "",
attrs: () => ({ type: "button" }),
press: ({ api }) => api.set(""),
bind: (el, part) => part.api.recovery.bind(el, part),
}),
}),
})
export { searchField }
import { createParts } from "@ui-sdk/react/primitive"
import { searchField } from "../lib/search-field"
const parts = createParts(searchField, { input: "input", clear: "button" })
const SearchField = parts.Root
const SearchFieldInput = parts.Input
const SearchFieldClear = parts.Clear
function Search() {
return (
<SearchField>
<SearchFieldInput placeholder="Search" />
<SearchFieldClear>Clear</SearchFieldClear>
</SearchField>
)
}
export { Search }
Nous avons ensuite lancé npm run build (le script est tsc -b && vite build). La compilation s'est terminée à 04:20 le 13 novembre 2026, Asia/Shanghai. Vite 8.3.8 a indiqué 189 modules transformed et built in 175ms. La commande complète a pris environ 0,88 seconde et s'est terminée avec le code 0. Nous n'avons pas ouvert de navigateur pour cliquer dans le champ ; une compilation réussie est le résultat de cette étape.
Ajouter le skill UI SDK pour Claude Code, Codex et Cursor
Pour qu'un agent suive le flux officiel (choisir des behaviors, définir un primitive, le rendre et le tester), la documentation donne cette commande d'installation :
npx skills add vercel-labs/ui --skill ui-sdk
Nous l'avons exécutée à la racine du même projet React. La durée réelle a été d'environ 6,71 secondes, code de sortie 0. Après avoir détecté l'environnement, l'installateur a copié le skill vers ./.agents/skills/ui-sdk dans le projet. La sortie mentionnait Cursor, Codex et un ensemble d'autres agents. La documentation officielle précise aussi que le même skill est livré avec @ui-sdk/core à node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md, toujours aligné sur la version installée. Si votre agent ne gère pas les skills, pointez-le vers ce fichier.
Le démarrage rapide React officiel demande aussi d'ajouter une note dans AGENTS.md, en créant le fichier s'il n'existe pas. Nous avons écrit le texte suivant, qui pointe vers la documentation livrée avec le paquet :
Before using ui-sdk, follow the ui-sdk skill if it is installed, and read
node_modules/@ui-sdk/react/docs/llms.txt. To build a new component, also search
node_modules/@ui-sdk/react/docs/core.md by heading, and read rendering.md next
to it.
Pour les autres frameworks, remplacez @ui-sdk/react dans ce chemin par le paquet correspondant. Pour les répertoires d'installation des skills et leur déclenchement dans les différents clients, voir Comment utiliser les Agent Skills et Comment installer et utiliser tstack. Si vous avez aussi besoin de hooks autour des appels d'outils, voir Comment configurer les Agent Hooks de Claude Code / Codex / Cursor.
L'invite officielle d'exemple pour un agent ressemble à ceci (adaptez le framework et l'interaction à votre application) :
Use ui-sdk to build a five-star rating in React.
Arrow keys should move between stars and choose a rating.
Use our existing styles and test the keyboard behavior.
Ce que nous avons exécuté : Claude Code et Codex ont chacun construit une évaluation à cinq étoiles
Nous avons confié le projet — SDK installé, AGENTS.md rédigé, skill ui-sdk déjà ajouté — à Claude Code et à Codex. L'invite était l'exemple officiel ci-dessus, plus la consigne de conserver le search-field existant, de brancher l'évaluation dans App.tsx et de lancer npm run build. Les deux exécutions ont utilisé l'API de ce site (la configuration est dans la section suivante) et un HOME isolé. Nous avons ensuite supprimé les configurations qui contenaient la clé. Pour Claude Code, nous avons aussi copié le skill dans .claude/skills/ui-sdk du projet, car c'est le répertoire qu'il lit par défaut.
Claude Code 2.1.319, modèle claude-opus-5-5, a démarré à 04:22:01 et s'est terminé à 04:23:06 le 13 novembre 2026, Asia/Shanghai. La durée réelle a été de 65,02 secondes. Le résultat JSON indiquait duration_ms 64442, num_turns 20 et subtype success. Il n'a pas utilisé le composant Rating fourni. Il a écrit src/lib/rating.ts avec definePrimitive, createChange et createRovingFocus issus de @ui-sdk/core, puis rendu src/components/Rating.tsx avec createParts. Les cinq étoiles sont des boutons role="radio" ; les flèches déplacent le focus et mettent à jour la valeur. Son propre npm run build s'est terminé avec le code 0 en environ 0,9 seconde et a transformé 191 modules. Nous avons recompilé ensuite dans le même répertoire : code de sortie 0, environ 0,79 seconde.
Codex CLI 0.167.0, modèle gpt-6.1-sol, a démarré au même moment et s'est terminé à 04:23:12. La durée réelle a été de 70,92 secondes. Il a pris l'autre chemin officiel : import de Rating et RatingItem depuis l'entrée fournie @ui-sdk/react/rating, rédaction de src/components/Rating.tsx, et ajout de tests qui utilisent createAgent(). Il a indiqué 2 tests réussis avec le code 0, et une compilation terminée avec le code 0 en 0,68 seconde (196 modules, Vite a affiché built in 147ms). Nous avons ensuite relancé npx vitest run --environment jsdom (Vitest 5.1.0) : Test Files 1 passed, Tests 2 passed, 802 ms. Une seconde compilation s'est terminée avec le code 0 et built in 157ms. Les deux tests couvrent la sélection au clavier avec un seul tab stop, et un agent qui appelle snapshot / act({ action: "setValue", args: [4] }) pour passer la note à 4. Codex a précisé qu'il n'avait pas fait de contrôle visuel dans un navigateur.
Cursor peut installer le même skill (l'installateur l'a listé parmi les cibles), mais nous n'avons pas lancé de tâche de génération dans Cursor. Le déclenchement dépend de votre version locale de Cursor.
Laisser un agent lire et piloter les composants de la page
Une fois les composants rendus, un agent peut aussi lire l'état et appeler des actions via le pont agent officiel. L'usage React, d'après la documentation Agents, est :
import { createAgent } from "@ui-sdk/react/agent"
const agent = createAgent()
agent.snapshot() liste les composants ui-sdk de la page, leur état et leurs actions disponibles. Un champ de texte avec un nom accessible, par exemple, peut exposer setValue et clear. Vous appelez ensuite :
await agent.act({
steps: [{ ref: "Project name", action: "setValue", args: ["Atlas"] }],
})
Les autres frameworks importent depuis @ui-sdk/vue/agent, @ui-sdk/svelte/agent, @ui-sdk/solid/agent ou @ui-sdk/web/agent. Le second test de Codex a utilisé cette API : il a exécuté setValue(4) sur l'évaluation, et le test a réussi. Vous pouvez aussi passer un callback allow à createAgent pour approuver ou refuser les actions demandées.
Pointer Claude Code, Codex ou Cursor vers une API Key de ce site
Le UI SDK n'est pas une API de modèle, vous n'avez donc pas à lui configurer de tarif de modèle. Si vous voulez que Claude Code, Codex ou Cursor utilisent les modèles de ce site pour construire des composants avec le skill, pointez le client vers ce site et collez votre API Key. Les trois clients sont listés côte à côte ; utilisez celui avec lequel vous travaillez déjà.
Pour Claude Code, écrivez ~/.claude/settings.json :
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "votre clé API AICodeWith"
}
}
Pour Codex, écrivez ~/.codex/config.toml. Le base_url doit être https://api.aicodewith.ai/chatgpt/v1, et non /v1. Utilisez le experimental_bearer_token global, et donnez à name la valeur "aicodewith" :
model_provider = "aicodewith"
model = "gpt-6.1-sol"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "votre clé API AICodeWith"
Dans Cursor, vous pouvez saisir une API personnalisée et un nom de modèle dans les réglages de modèle. Nous n'avons pas exécuté ce chemin, donc la connexion dépend de votre version locale de Cursor.
Si vous voulez une clé de ce site pour une génération comme celle-ci, vous pouvez la créer ci-dessous.
Erreurs fréquentes et corrections
| Erreur ou symptôme | Pourquoi | Que faire |
|---|---|---|
| L'installation ou la vérification de types signale une peer React non satisfaite | @ui-sdk/react exige React 19+ | Passez react et react-dom en version 19 ou plus récente ; en TypeScript, passez aussi @types/react en 19.2.10 ou plus récente |
| Vous n'avez installé que @ui-sdk/react et l'import ou l'exécution échoue | @ui-sdk/core est une peer dependency ; les docs demandent d'installer les deux pour n'avoir qu'une copie du core | Lancez aussi npm install @ui-sdk/core |
| Cannot find module '@ui-sdk/react' ou un nom de composant manque | Les docs indiquent qu'il n'y a pas d'export racine ; les composants s'importent depuis leur propre entrée | Importez par exemple import { Dialog, DialogTrigger } from "@ui-sdk/react/dialog" |
| L'agent ignore le skill ui-sdk ou ne trouve pas la documentation | Le skill n'est pas dans un répertoire lu par ce client, ou AGENTS.md ne pointe pas vers le llms.txt livré avec le paquet | Relancez npx skills add vercel-labs/ui --skill ui-sdk, mettez à jour AGENTS.md comme le décrivent les docs, ou pointez l'agent vers node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md |
| Codex indique que le modèle n'existe pas, alors que vous avez utilisé un modèle listé | Le base_url a été défini sur https://api.aicodewith.ai/v1 | Remplacez-le par https://api.aicodewith.ai/chatgpt/v1 |
| La compilation réussit, mais le bouton Clear n'apparaît jamais ou le focus ne revient pas dans le champ | present ou createFocusRecovery n'a pas été branché comme dans l'exemple officiel, ou Clear n'est pas dans le même Root du primitive | Comparez vos present, press et bind avec l'exemple officiel search-field |
| Après une mise à jour mineure, l'API ne correspond plus à la documentation que vous aviez enregistrée | C'est une beta, et les docs officielles indiquent que les API peuvent encore changer | Fiez-vous à la documentation livrée dans node_modules/@ui-sdk/*/docs/ pour la version installée, pas seulement au site, qui peut déjà avoir avancé |
FAQ
En quoi le UI SDK diffère-t-il d'une bibliothèque de composants classique ?
D'après la documentation officielle, les behaviors vivent dans @ui-sdk/core, indépendamment du framework, et les adaptateurs ne font que les rendre. Les composants fournis comme Select, Dialog, Tabs et Rating s'appuient sur les mêmes behaviors, sans styles, sans provider et sans portail. Vous pouvez aussi ignorer les composants fournis et composer votre propre interface avec definePrimitive.
Faut-il forcément utiliser React ?
Non. Des adaptateurs officiels existent aussi pour Vue, Svelte, Solid et Web Components. Cette exécution a suivi le chemin React 19.3.1. Pour les autres frameworks, remplacez le paquet comme le décrivent les docs officielles. Nous n'avons pas relancé la compilation sur ces frameworks cette fois.
Un agent doit-il forcément utiliser le skill ?
Non. Les docs officielles indiquent : si votre agent gère les skills, lancez npx skills add vercel-labs/ui --skill ui-sdk. Sinon, pointez-le vers node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md ou vers le llms.txt livré avec le paquet. Nous avons confirmé que les deux fichiers étaient présents après l'installation.
Peut-on utiliser la beta en production ?
La documentation officielle indique que le SDK est en beta, que les API peuvent encore changer, et elle renvoie au Vercel Public Beta Agreement. L'usage en production est une décision que vous prenez selon ces conditions et votre propre tolérance au risque. Cet article consigne seulement ce que nous avons observé pour l'installation, la compilation et les composants générés par un agent.
Pourquoi cette exécution n'inclut-elle pas Cursor ?
L'installateur a déjà listé Cursor parmi les cibles du skill, mais nous n'avons pas lancé de tâche de génération dans Cursor. La configuration Cursor de cet article suit le réglage habituel de ce site et n'a pas été contrôlée dans cette exécution.
Si vous voulez exécuter Claude Code ou Codex avec les modèles de ce site, vous pouvez d'abord créer une API Key.



