El UI SDK es una biblioteca de comportamientos para agentes de programación. Según el README oficial del repositorio y la documentación, la navegación por teclado, el foco, la selección, el cierre o el descarte, las capas emergentes, el arrastre y los atributos ARIA que necesitan esas interacciones viven en el paquete TypeScript independiente del framework @ui-sdk/core. Luego los adaptadores los renderizan con @ui-sdk/react, @ui-sdk/vue, @ui-sdk/svelte, @ui-sdk/solid y @ui-sdk/web. No es una API de modelo y no decide el aspecto: tanto los componentes incluidos como las partes que compones con definePrimitive van sin estilos, sin provider y sin portal.
@vercel lo anunció el 12 de noviembre de 2026 a las 18:41 UTC (13 de noviembre a las 02:41, Asia/Shanghai) con la publicación «Introducing the UI SDK.» En la misma ventana, @shadcn explicó el enfoque de diseño, y @rauchg lo comparó con «the x86 instruction set for agents». La documentación está en ui-sdk.dev y el código fuente en vercel-labs/ui. En npm, @ui-sdk/core, @ui-sdk/react y los demás paquetes de framework publican ahora 0.1.0-beta.1, con licencia Apache-2.0.
El 13 de noviembre de 2026 (Asia/Shanghai, UTC+8) ejecutamos el SDK en una máquina Debian 13 x86_64 con Node.js v24.22.2, npm 11.19.1 y React 19.3.1. npm install @ui-sdk/react @ui-sdk/core instaló 0.1.0-beta.1. Copiamos el ejemplo oficial search-field del README a una aplicación mínima de Vite y React, y npm run build (tsc -b && vite build) terminó correctamente. Después ejecutamos npx skills add vercel-labs/ui --skill ui-sdk y pedimos a Claude Code 2.1.319 y a Codex CLI 0.167.0, a través de la API de este sitio y del skill, que cada uno generara una valoración de cinco estrellas. Esta vez no ejecutamos una tarea de agente en Cursor. Las versiones, comandos, tiempos y salidas que siguen salen de esa ejecución.
En resumen
| Pregunta | Respuesta |
|---|---|
| Qué es el UI SDK? | Una biblioteca de comportamientos para agentes: las interacciones y ARIA viven en @ui-sdk/core, y los adaptadores de framework las renderizan. |
| Versión actual | npm 0.1.0-beta.1 (publicada el 12 de noviembre de 2026, Apache-2.0). La peer dependency del adaptador de React es React 19+. |
| Cómo se instala? | En React: npm install @ui-sdk/react @ui-sdk/core. En otros frameworks, cambia @ui-sdk/react por el paquete correspondiente. |
| Cómo se lo das a un agente? | Ejecuta npx skills add vercel-labs/ui --skill ui-sdk y actualiza AGENTS.md como indican las docs, apuntando a la documentación incluida con el paquete, por ejemplo node_modules/@ui-sdk/react/docs/llms.txt. |
| Cómo se construye un componente propio? | Combina behaviors con definePrimitive y luego renderízalos con createParts en tu framework. Las guías oficiales incluyen search-field, un botón mute y una barra de reacciones. |
| Y los componentes ya incluidos? | @ui-sdk/react también ofrece componentes listos como Select, Dialog, Tabs y Rating. Van sin estilos y no necesitan provider ni portal. |
| Qué ejecutamos | La instalación tardó unos 0,8 s. La compilación del search-field oficial terminó bien en unos 0,9 s. Añadir el skill tardó unos 6,7 s. Claude Code generó una valoración en unos 65 s y Codex en unos 71 s; ambas compilaciones terminaron bien, y los 2 tests de Codex pasaron. |
| Qué hay que tener en cuenta | Está en beta y se rige por los términos de public beta de Vercel. La documentación oficial indica que las API todavía pueden cambiar. |
Qué es el UI SDK
Según la documentación oficial y el README, el UI SDK no es otra biblioteca de componentes ya estilizados. Describe «cómo se comporta una interfaz» como behaviors composables y deja que una persona o un agente arme componentes con ellos. El mismo primitive puede renderizarse en React, Vue, Svelte, Solid y Web Components.
Según @shadcn, los agentes se están convirtiendo a la vez en quienes construyen y quienes usan las interfaces, así que la abstracción debe vivir en la capa de comportamiento. Un Select, por ejemplo, tiene una capa emergente, lógica de selección, navegación por teclado y gestión del foco, piezas que reaparecen en muchos otros componentes. Esas piezas se separaron, se probaron y se hicieron reutilizables, y el comportamiento se mantiene igual sea cual sea el framework, el renderizador o el harness. El objetivo, escribió, es dar a los agentes las piezas para generar la interfaz que necesitas, incluidas interfaces «we haven't thought of yet».
Según @rauchg, el UI SDK es «like the x86 instruction set for agents» para construir de forma espontánea nuevos componentes de interfaz.
La documentación oficial ofrece dos caminos en paralelo:
- Componer tú los behaviors: define las partes, el estado y las acciones con
definePrimitivey renderízalos concreateParts. La guía del repositorio es un search-field; las docs también incluyen un botón mute y la barra de reacciones en Build a Component. - Usar los componentes incluidos:
@ui-sdk/reactexporta cada componente desde su propia entrada, como@ui-sdk/react/button,@ui-sdk/react/dialog,@ui-sdk/react/tabsy@ui-sdk/react/rating. Las docs indican que no hay un import raíz desde@ui-sdk/react. Los componentes van sin estilos, sin dependencias, sin provider y sin portal; el CSS o Tailwind lo pones tú.
Para que un agente opere una página ya renderizada, puedes llamar a createAgent() para leer el estado de los componentes e invocar acciones. Esa API está documentada en Agents. La documentación oficial de Agents también incluye una comparación de project-settings (mediana de tres ejecuciones por enfoque, todas con Sonnet a través de Claude Code, todas completadas): las herramientas del navegador hicieron 16 llamadas a herramientas y tardaron 41 segundos; el puente de agente de ui-sdk hizo 5 llamadas y tardó 16 segundos. Esas cifras salen del experimento oficial, no de una repetición en nuestra máquina.
El UI SDK está en beta. El sitio de documentación dice: «UI SDK is in beta, so some APIs may still change.» El uso se rige por el Vercel Public Beta Agreement. Antes de la disponibilidad general, las API, la documentación y los behaviors todavía pueden cambiar.
Fecha de publicación y conversación
La hora oficial de lanzamiento es la de la publicación de @vercel: 2026-11-12 18:41:04 UTC, que corresponde a 2026-11-13 02:41:04 en Asia/Shanghai. En npm, @ui-sdk/react@0.1.0-beta.1 se publicó el 2026-11-12 17:09:05 UTC (01:09 en Asia/Shanghai) y @ui-sdk/core@0.1.0-beta.1 a las 17:12:06 UTC (01:12).
Según los datos públicos de X, a 13 de noviembre de 2026 a las 04:23 Asia/Shanghai:
- La publicación de @vercel: 1.420 me gusta, 93.978 impresiones, 892 guardados
- El texto de @shadcn: 1.519 me gusta, 45.079 impresiones, 1.064 guardados
- El comentario de @rauchg: 221 me gusta, 10.762 impresiones
Si ya sigues otras herramientas de agente de Vercel, también puedes comparar Cómo usar Vercel agent-desktop y Cómo usar Cursor Live Apps.
Instalar 0.1.0-beta.1 en un proyecto de React 19
La documentación oficial de instalación en React exige React 19 y React DOM 19 o posterior. Creamos una aplicación mínima con create-vite@9.3.4 y la plantilla react-ts, que traía react@19.3.1 / react-dom@19.3.1 y @types/react@19.3.0 (las docs también piden @types/react 19.2.10 o posterior para TypeScript).
npm install @ui-sdk/react @ui-sdk/core
Ejecutamos este comando a las 04:20 del 13 de noviembre de 2026, Asia/Shanghai. npm mostró added 2 packages, and audited 31 packages in 797ms. El tiempo real fue de unos 0,86 segundos, código de salida 0. npm ls mostró:
@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
Los dos paquetes del SDK tienen licencia Apache-2.0. Las peer dependencies de @ui-sdk/react son react / react-dom >=19 y @ui-sdk/core ^0.1.0-beta.1. Para otros frameworks, el README oficial indica cambiar @ui-sdk/react por @ui-sdk/vue, @ui-sdk/svelte, @ui-sdk/solid o @ui-sdk/web, e instalar también @ui-sdk/core.
Compilar el ejemplo oficial search-field
La guía del README oficial es un campo de búsqueda con un botón Clear: el botón solo aparece cuando el campo tiene texto, y al pulsarlo se vacía el campo y el foco vuelve a la entrada. Copiamos el primitive y el renderizado de React en src/lib/search-field.ts y src/components/Search.tsx, y en App.tsx también renderizamos el Toggle de la guía oficial First Component.
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 }
Después ejecutamos npm run build (el script es tsc -b && vite build). La compilación terminó a las 04:20 del 13 de noviembre de 2026, Asia/Shanghai. Vite 8.3.8 indicó 189 modules transformed y built in 175ms. El comando completo tardó unos 0,88 segundos y terminó con código 0. No abrimos un navegador para hacer clic en el campo; una compilación correcta es el resultado de este paso.
Añadir el skill de UI SDK para Claude Code, Codex y Cursor
Para que un agente siga el flujo oficial (elegir behaviors, definir un primitive, renderizarlo y probarlo), la documentación da este comando de instalación:
npx skills add vercel-labs/ui --skill ui-sdk
Lo ejecutamos en la raíz del mismo proyecto de React. El tiempo real fue de unos 6,71 segundos, código de salida 0. Tras detectar el entorno, el instalador copió el skill a ./.agents/skills/ui-sdk en el proyecto. La salida mencionaba Cursor, Codex y un conjunto de otros agentes. La documentación oficial también indica que el mismo skill se entrega con @ui-sdk/core en node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md, siempre alineado con la versión instalada. Si tu agente no admite skills, apunta a ese archivo.
El inicio rápido de React oficial también pide añadir una nota en AGENTS.md, creando el archivo si hace falta. Escribimos el texto siguiente, que apunta a la documentación incluida con el paquete:
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.
En otros frameworks, cambia @ui-sdk/react en esa ruta por el paquete correspondiente. Para los directorios de instalación de skills y cómo se disparan en distintos clientes, consulta Cómo usar Agent Skills y Cómo instalar y usar tstack. Si también necesitas hooks alrededor de las llamadas a herramientas, consulta Cómo configurar Agent Hooks de Claude Code / Codex / Cursor.
La indicación de ejemplo oficial para un agente es esta (adapta el framework y la interacción a tu aplicación):
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.
Lo que ejecutamos: Claude Code y Codex construyeron cada uno una valoración de cinco estrellas
Entregamos el proyecto (SDK instalado, AGENTS.md escrito y skill ui-sdk ya añadido) a Claude Code y a Codex. La indicación era el ejemplo oficial de arriba, más la instrucción de conservar el search-field existente, conectar la valoración en App.tsx y ejecutar npm run build. Ambas ejecuciones usaron la API de este sitio (la configuración está en la sección siguiente) y un HOME aislado. Después borramos las configuraciones que contenían la clave. Para Claude Code también copiamos el skill a .claude/skills/ui-sdk del proyecto, porque ese es el directorio que lee de forma predeterminada.
Claude Code 2.1.319, modelo claude-opus-5-5, empezó a las 04:22:01 y terminó a las 04:23:06 del 13 de noviembre de 2026, Asia/Shanghai. El tiempo real fue de 65,02 segundos. El resultado JSON indicó duration_ms 64442, num_turns 20 y subtype success. No usó el componente Rating incluido. Escribió src/lib/rating.ts con definePrimitive, createChange y createRovingFocus de @ui-sdk/core, y renderizó src/components/Rating.tsx con createParts. Las cinco estrellas son botones role="radio"; las flechas mueven el foco y actualizan el valor. Su propio npm run build terminó con código 0 en unos 0,9 segundos y transformó 191 módulos. Luego volvimos a compilar en el mismo directorio: código de salida 0, unos 0,79 segundos.
Codex CLI 0.167.0, modelo gpt-6.1-sol, empezó al mismo tiempo y terminó a las 04:23:12. El tiempo real fue de 70,92 segundos. Tomó el otro camino oficial: importó Rating y RatingItem desde la entrada incluida @ui-sdk/react/rating, escribió src/components/Rating.tsx y añadió tests que usan createAgent(). Informó 2 tests superados con código 0 y una compilación terminada con código 0 en 0,68 segundos (196 módulos; Vite mostró built in 147ms). Después repetimos npx vitest run --environment jsdom (Vitest 5.1.0): Test Files 1 passed, Tests 2 passed, 802 ms. Una segunda compilación terminó con código 0 y built in 157ms. Los dos tests cubren la selección con flechas y un solo tab stop, y un agente que llama a snapshot / act({ action: "setValue", args: [4] }) para dejar la valoración en 4. Codex indicó que no hizo comprobaciones visuales en un navegador.
Cursor puede instalar el mismo skill (el instalador lo listó como destino), pero no ejecutamos una tarea de generación dentro de Cursor. Si se dispara bien depende de tu versión local de Cursor.
Dejar que un agente lea y opere los componentes de la página
Cuando los componentes ya están renderizados, un agente también puede leer el estado y llamar acciones a través del puente oficial. El uso en React, según la documentación de Agents, es:
import { createAgent } from "@ui-sdk/react/agent"
const agent = createAgent()
agent.snapshot() enumera los componentes ui-sdk de la página, su estado y las acciones disponibles. Un campo de texto con un nombre accesible, por ejemplo, puede exponer setValue y clear. Después llamas:
await agent.act({
steps: [{ ref: "Project name", action: "setValue", args: ["Atlas"] }],
})
Los demás frameworks importan desde @ui-sdk/vue/agent, @ui-sdk/svelte/agent, @ui-sdk/solid/agent o @ui-sdk/web/agent. El segundo test de Codex usó esta API: ejecutó setValue(4) sobre la valoración y el test pasó. También puedes pasar a createAgent un callback allow para aprobar o rechazar las acciones pedidas.
Apuntar Claude Code, Codex o Cursor a una API Key de este sitio
El UI SDK no es una API de modelo, así que no le configuras precios de modelo. Si quieres que Claude Code, Codex o Cursor usen los modelos de este sitio para construir componentes con el skill, apunta el cliente a este sitio y pega tu API Key. Los tres clientes aparecen en paralelo; usa el que ya empleas.
Para Claude Code, escribe ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "tu API Key de AICodeWith"
}
}
Para Codex, escribe ~/.codex/config.toml. El base_url debe ser https://api.aicodewith.ai/chatgpt/v1, no /v1. Usa el experimental_bearer_token global y pon name en "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 = "tu API Key de AICodeWith"
En Cursor puedes indicar una API personalizada y un nombre de modelo en la configuración de modelos. No ejecutamos ese camino, así que si conecta o no depende de tu versión local de Cursor.
Si quieres una clave de este sitio para una generación como esta, puedes crearla abajo.
Errores frecuentes y soluciones
| Error o síntoma | Por qué ocurre | Qué hacer |
|---|---|---|
| La instalación o la comprobación de tipos indica una peer de React no satisfecha | @ui-sdk/react exige React 19+ | Actualiza react y react-dom a 19 o posterior; en TypeScript, actualiza también @types/react a 19.2.10 o posterior |
| Solo instalaste @ui-sdk/react y falla el import o la ejecución | @ui-sdk/core es una peer dependency; las docs piden instalar ambos para compartir una sola copia del core | Ejecuta también npm install @ui-sdk/core |
| Cannot find module '@ui-sdk/react' o falta el nombre de un componente | Las docs indican que no hay un export raíz; los componentes se importan desde su propia entrada | Importa, por ejemplo, import { Dialog, DialogTrigger } from "@ui-sdk/react/dialog" |
| El agente ignora el skill ui-sdk o no encuentra la documentación | El skill no está en un directorio que ese cliente lea, o AGENTS.md no apunta al llms.txt incluido con el paquete | Vuelve a ejecutar npx skills add vercel-labs/ui --skill ui-sdk, actualiza AGENTS.md como indican las docs, o apunta el agente a node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md |
| Codex dice que el modelo no existe, pero usaste un modelo que sí aparece en el catálogo | El base_url se definió como https://api.aicodewith.ai/v1 | Cámbialo a https://api.aicodewith.ai/chatgpt/v1 |
| La compilación termina bien, pero el botón Clear no aparece o el foco no vuelve al campo | No se conectó present o createFocusRecovery como en el ejemplo oficial, o Clear no está dentro del mismo Root del primitive | Compara tus present, press y bind con el ejemplo oficial search-field |
| Tras una actualización menor, la API ya no coincide con la documentación que habías guardado | Está en beta, y las docs oficiales indican que las API todavía pueden cambiar | Confía en la documentación incluida en node_modules/@ui-sdk/*/docs/ de la versión instalada, no solo en el sitio, que puede haber avanzado ya |
FAQ
En qué se diferencia el UI SDK de una biblioteca de componentes habitual?
Según la documentación oficial, los behaviors viven en @ui-sdk/core, independientes del framework, y los adaptadores solo los renderizan. Los componentes incluidos como Select, Dialog, Tabs y Rating se basan en los mismos behaviors, van sin estilos y no necesitan provider ni portal. También puedes prescindir de los componentes incluidos y componer tu propia interfaz con definePrimitive.
Es obligatorio usar React?
No. También hay adaptadores oficiales para Vue, Svelte, Solid y Web Components. Esta ejecución siguió la ruta de React 19.3.1. En otros frameworks, cambia el paquete como indican las docs oficiales. Esta vez no repetimos la compilación en esos frameworks.
Un agente tiene que usar el skill?
No. Las docs oficiales dicen: si tu agente admite skills, ejecuta npx skills add vercel-labs/ui --skill ui-sdk. Si no, apúntalo a node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md o al llms.txt incluido con el paquete. Confirmamos que ambos archivos estaban presentes después de la instalación.
Se puede usar la beta en producción?
La documentación oficial indica que el SDK está en beta, que las API todavía pueden cambiar, y remite al Vercel Public Beta Agreement. Usarlo en producción es una decisión que tomas según esos términos y tu propia tolerancia al riesgo. Este artículo solo registra lo que vimos en la instalación, la compilación y los componentes generados por un agente.
Por qué esta ejecución no incluye Cursor?
El instalador ya listó Cursor como destino del skill, pero no iniciamos una tarea de generación dentro de Cursor. La configuración de Cursor de este artículo sigue el ajuste habitual de este sitio y no se comprobó en esta ejecución.
Si quieres ejecutar Claude Code o Codex con los modelos de este sitio, puedes crear primero una API Key.



