UI SDK は、コーディング Agent 向けの振る舞い(behaviors)ライブラリです。公式リポジトリの README と ドキュメント によれば、キーボード操作、フォーカス、選択、閉じる/dismiss、ポップアップ、ドラッグ&ドロップ、そしてそれらに必要な ARIA は、フレームワーク非依存の TypeScript コアパッケージ @ui-sdk/core にあります。アダプターが @ui-sdk/react、@ui-sdk/vue、@ui-sdk/svelte、@ui-sdk/solid、@ui-sdk/web として各フレームワークに描画します。モデル API ではなく、見た目も決めません。同梱コンポーネントも、definePrimitive で組み立てる部品もスタイルなしで、provider もポータルもありません。
@vercel は 2026 年 11 月 12 日 18:41 UTC(Asia/Shanghai では 11 月 13 日 02:41)に「Introducing the UI SDK.」と発表しました。同じ時間帯に @shadcn が設計方針を説明し、@rauchg は「the x86 instruction set for agents」になぞらえました。ドキュメントは ui-sdk.dev、ソースは vercel-labs/ui です。npm 上の @ui-sdk/core、@ui-sdk/react、その他のフレームワーク用パッケージの最新は現在 0.1.0-beta.1 で、ライセンスは Apache-2.0 です。
2026 年 11 月 13 日(Asia/Shanghai、UTC+8)、Debian 13 x86_64 のマシンで Node.js v24.22.2、npm 11.19.1、React 19.3.1 を使って実測しました。npm install @ui-sdk/react @ui-sdk/core で入ったのは 0.1.0-beta.1 です。公式 README の search-field 例を最小の Vite + React プロジェクトに書き込み、npm run build(tsc -b && vite build)は成功しました。続けて npx skills add vercel-labs/ui --skill ui-sdk を実行し、Claude Code 2.1.319 と Codex CLI 0.167.0 に、本サイトの API と skill を使ってそれぞれ五段階評価コンポーネントを生成させました。今回、Cursor の Agent タスクは実行していません。以下のバージョン、コマンド、所要時間、出力は、この実行から取っています。
先に結論
| 問い | 答え |
|---|---|
| UI SDK とは? | Agent 向けの振る舞いライブラリです。インタラクションと ARIA は @ui-sdk/core にあり、各フレームワークのアダプターが描画します。 |
| 現在のバージョン | npm 0.1.0-beta.1(2026 年 11 月 12 日公開、Apache-2.0)。React アダプターの peer 依存は React 19+ です。 |
| どう入れるか | React では npm install @ui-sdk/react @ui-sdk/core。他のフレームワークでは @ui-sdk/react を対応パッケージに差し替えます。 |
| Agent にどう渡すか | npx skills add vercel-labs/ui --skill ui-sdk を実行し、公式の説明どおり AGENTS.md を更新して、node_modules/@ui-sdk/react/docs/llms.txt などの同梱ドキュメントを指します。 |
| 自分でコンポーネントを書くには | definePrimitive で behaviors を組み合わせ、createParts で各フレームワークに描画します。公式の案内例には search-field、ミュートボタン、reactions bar があります。 |
| 既製コンポーネントは? | @ui-sdk/react は Select、Dialog、Tabs、Rating なども提供します。スタイルなしで、provider もポータルも不要です。 |
| 今回の実行 | インストールは約 0.8 秒。公式 search-field のビルドは約 0.9 秒で成功。skill の追加は約 6.7 秒。Claude Code は約 65 秒、Codex は約 71 秒で評価コンポーネントを生成し、どちらもビルドは成功、Codex のテスト 2 件も成功しました。 |
| 注意点 | 現在は beta で、Vercel の public beta 条項の対象です。公式ドキュメントは API がまだ変わる可能性があると書いています。 |
UI SDK とは何か
公式ドキュメント と README によれば、UI SDK は見た目付きのコンポーネント集ではありません。「インターフェースがどう動くか」を組み合わせ可能な振る舞いとして書き、人または Agent がそれを使ってコンポーネントを組み立てます。同じ primitive を React、Vue、Svelte、Solid、Web Components に描画できます。
@shadcn によれば、Agent はインターフェースの作り手と使い手の両方になりつつあるため、抽象は振る舞いの層に置くべきです。たとえば Select にはポップアップ、選択ロジック、キーボード操作、フォーカス管理があり、同じ部品は他のコンポーネントにも繰り返し現れます。それらを切り出し、テストし、再利用できるようにした結果、振る舞いはフレームワークやレンダラー、harness が変わっても同じです。目標は、必要なインターフェースを、まだ思い至っていないものも含めて、Agent が生成できるようにすることだと書かれています(原文は「we haven't thought of yet」)。
@rauchg の比喩では、UI SDK は新しい UI コンポーネントをその場で組み立てるための「the x86 instruction set for agents」です。
公式ドキュメントは次の二つの道を並行して示しています。
- 自分で振る舞いを組む:
definePrimitiveで部品、状態、アクションを定義し、createPartsで描画します。リポジトリの案内例は search-field です。ドキュメントにはミュートボタンと、Build a Component の reactions bar もあります。 - 既製コンポーネントを使う:
@ui-sdk/reactはコンポーネントごとにエントリを分けてエクスポートします。例は@ui-sdk/react/button、@ui-sdk/react/dialog、@ui-sdk/react/tabs、@ui-sdk/react/ratingです。公式は@ui-sdk/reactのルートからの一括 import はないと明記しています。コンポーネントはスタイルなし、依存なし、provider なし、ポータルなしで、CSS や Tailwind は自分で足します。
すでに描画されたページを Agent に操作させるには、createAgent() でコンポーネントの状態を読み、actions を呼び出せます。API は Agents にあります。公式 Agents ドキュメントには project-settings の比較実験もあります(各手法 3 回の中央値、どちらも Sonnet を Claude Code 経由で使用、すべて完了)。ブラウザツールはツール呼び出し 16 回、所要 41 秒。ui-sdk の agent bridge はツール呼び出し 5 回、所要 16 秒です。これは公式実験の数字であり、私たちが再測定したものではありません。
UI SDK は現在 beta です。ドキュメントサイトには「UI SDK is in beta, so some APIs may still change.」とあります。利用は Vercel Public Beta Agreement の対象です。正式な GA の前に、API、ドキュメント、振る舞いはまだ変わる可能性があります。
公開時刻と議論
公式の発表時刻は @vercel の投稿 に合わせます。2026-11-12 18:41:04 UTC、Asia/Shanghai では 2026-11-13 02:41:04 です。npm では @ui-sdk/react@0.1.0-beta.1 が 2026-11-12 17:09:05 UTC(Asia/Shanghai 01:09)、@ui-sdk/core@0.1.0-beta.1 が 17:12:06 UTC(01:12)に公開されています。
X の公開データによれば、2026 年 11 月 13 日 04:23 Asia/Shanghai 時点で次のとおりです。
- @vercel の発表投稿:いいね 1,420、表示 93,978、ブックマーク 892
- @shadcn の説明:いいね 1,519、表示 45,079、ブックマーク 1,064
- @rauchg のコメント:いいね 221、表示 10,762
すでに Vercel の他の Agent 製品を追っている場合は、Vercel agent-desktop の使い方 と Cursor Live Apps の使い方 も対照できます。
React 19 のプロジェクトに 0.1.0-beta.1 を入れる
公式の React インストール手順 は、React 19 と React DOM 19 以上を要求します。私たちは create-vite@9.3.4 の react-ts テンプレートで最小アプリを作りました。テンプレートに含まれていたのは react@19.3.1 / react-dom@19.3.1 と @types/react@19.3.0 です(公式は TypeScript 利用時に @types/react 19.2.10 以上も求めています)。
npm install @ui-sdk/react @ui-sdk/core
このコマンドは 2026 年 11 月 13 日 04:20 Asia/Shanghai に実行しました。npm の出力は added 2 packages, and audited 31 packages in 797ms で、実時間は約 0.86 秒、終了コードは 0 です。npm ls の結果は次のとおりです。
@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
両方の SDK パッケージのライセンスは Apache-2.0 です。@ui-sdk/react の peer 依存は react / react-dom >=19 と @ui-sdk/core ^0.1.0-beta.1 です。他のフレームワークでは、公式 README のとおり @ui-sdk/react を @ui-sdk/vue、@ui-sdk/svelte、@ui-sdk/solid、@ui-sdk/web のいずれかに差し替え、同じく @ui-sdk/core を入れてください。
公式の search-field 例を書いてビルドする
公式 README の案内例は、Clear ボタン付きの search-field です。入力に文字があるときだけ Clear が表示され、押すと空にしてフォーカスを入力へ戻します。私たちは primitive と React の描画を src/lib/search-field.ts と src/components/Search.tsx に書き、App.tsx では公式 First Component 案内の Toggle も描画しました。
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 }
そのあとプロジェクトで npm run build(スクリプトは tsc -b && vite build)を実行しました。ビルドは 2026 年 11 月 13 日 04:20 Asia/Shanghai に終わり、Vite 8.3.8 は 189 modules transformed と built in 175ms を出力しました。コマンド全体の実時間は約 0.88 秒、終了コードは 0 です。ブラウザを開いて検索欄をクリックしてはいません。この段階の結果は、ビルドが通ったことです。
Claude Code / Codex / Cursor 向けに UI SDK skill を入れる
Agent が公式の流れ(振る舞いを選び、primitive を定義し、描画し、テストする)に沿うために、ドキュメントが示しているインストールコマンドは次です。
npx skills add vercel-labs/ui --skill ui-sdk
同じ React プロジェクトのルートで実行し、実時間は約 6.71 秒、終了コードは 0 でした。インストーラーは環境を検出したうえで、skill をプロジェクト内の ./.agents/skills/ui-sdk にコピーしました。出力には Cursor、Codex、その他の一連の Agent が対象として書かれていました。公式は、同じ skill が @ui-sdk/core に同梱され、パスは node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md で、インストールしたパッケージ版と常に一致するとも説明しています。Agent が skills に対応していない場合は、このファイルを指してください。
公式の React クイックスタート は、AGENTS.md に注記を足すこと(なければ新規作成)も求めています。私たちは同梱ドキュメントを指す次の内容を書きました。
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.
他のフレームワークでは、このパスの @ui-sdk/react を対応パッケージ名に差し替えます。Skill のインストール場所と、各クライアントでの発火の仕方は、Agent Skills の使い方 と tstack の入れ方・使い方 も参照できます。ツール呼び出しの前後にフックを足す場合は、Claude Code / Codex / Cursor の Agent Hooks の設定 を見てください。
公式が Agent に渡す例のプロンプトは次のとおりです(フレームワークとインタラクションは自分のアプリに合わせて変えてください)。
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.
実測:Claude Code と Codex がそれぞれ五段階評価を生成した
SDK を入れ、AGENTS.md を書き、ui-sdk skill を追加済みのプロジェクトを、Claude Code と Codex に渡しました。プロンプトは上の公式例に加え、既存の search-field を残すこと、評価コンポーネントを App.tsx につなぐこと、最後に npm run build を走らせることを指示しました。どちらも本サイトの API(設定は次節)と隔離した HOME を使い、終わったら Key を含む設定を削除しました。Claude Code 向けには、標準で読む .claude/skills/ui-sdk にも skill をコピーしました。
Claude Code 2.1.319、モデル claude-opus-5-5 は、2026 年 11 月 13 日 04:22:01 に開始し、04:23:06 に終了しました(Asia/Shanghai)。実時間は 65.02 秒です。JSON 結果の duration_ms は 64442、num_turns は 20、subtype は success でした。既製の Rating コンポーネントは使わず、@ui-sdk/core の definePrimitive、createChange、createRovingFocus で src/lib/rating.ts を書き、createParts で src/components/Rating.tsx を描画しました。五つの星は role="radio" のボタンで、矢印キーがフォーカスを移し値を更新します。自身が走らせた npm run build の終了コードは 0、約 0.9 秒、191 モジュールでした。同じディレクトリで私たちが再ビルドした結果も終了コード 0、約 0.79 秒です。
Codex CLI 0.167.0、モデル gpt-6.1-sol は同時刻に開始し、04:23:12 に終了、実時間は 70.92 秒でした。こちらはもう一つの公式経路で、既製の @ui-sdk/react/rating から Rating と RatingItem を import して src/components/Rating.tsx を書き、createAgent() を使うテストも追加しました。報告ではテスト 2 件成功、終了コード 0、ビルドも終了コード 0 で 0.68 秒(196 モジュール、Vite は built in 147ms)でした。その後私たちが npx vitest run --environment jsdom(Vitest 5.1.0)を再実行した結果は Test Files 1 passed、Tests 2 passed、802ms です。再ビルドも終了コード 0、built in 157ms でした。二つのテストは、矢印キーでの選択とタブストップが一つであること、および agent が snapshot / act({ action: "setValue", args: [4] }) で評価を 4 にすることです。Codex は、ブラウザでの見た目確認はしていないと書いています。
Cursor でも同じ skill を入れられます(今回のインストーラーも対象に挙げていました)。ただし Cursor 内で生成タスクは実行していません。うまく発火するかどうかは、お手元の Cursor のバージョンに依ります。
ページ上のコンポーネントを Agent に読み書きさせる
コンポーネントが描画されたあと、公式の agent bridge を通じて状態を読み、actions を呼ぶこともできます。React での書き方は Agents ドキュメント によれば次です。
import { createAgent } from "@ui-sdk/react/agent"
const agent = createAgent()
agent.snapshot() は、ページ上の ui-sdk コンポーネント、その状態、利用可能な actions を返します。アクセス可能な名前を持つ入力欄なら、setValue や clear が含まれることがあります。続けて次のように呼びます。
await agent.act({
steps: [{ ref: "Project name", action: "setValue", args: ["Atlas"] }],
})
他のフレームワークでは @ui-sdk/vue/agent、@ui-sdk/svelte/agent、@ui-sdk/solid/agent、@ui-sdk/web/agent から import します。上の Codex の二つ目のテストがこの API を使っており、評価コンポーネントに対して setValue(4) を実行し、テストは成功しました。createAgent に allow コールバックを渡し、許可する動作を制御することもできます。
Claude Code / Codex / Cursor を本サイトの API Key に接続する
UI SDK 自体はモデル API ではないので、モデル料金を設定する必要はありません。Claude Code、Codex、Cursor が本サイトのモデルを使って skill に沿ってコンポーネントを書くようにするには、クライアントを本サイトに向け、本サイトの API Key を入れてください。三つのクライアントは並列に扱います。普段使っているものを選んでください。
Claude Code では ~/.claude/settings.json を書きます。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "あなたの AICodeWith API Key"
}
}
Codex では ~/.codex/config.toml を書きます。base_url は https://api.aicodewith.ai/chatgpt/v1 で、/v1 にしてはいけません。グローバルな experimental_bearer_token を使い、name は "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 = "あなたの AICodeWith API Key"
Cursor では、モデル設定にカスタム API とモデル名を入れられます。この経路は今回実行していないため、接続できるかどうかはお手元の Cursor のバージョンに依ります。
今回のような生成を本サイトの Key で行う場合は、次から作成できます。
よくあるエラーと対処
| エラー / 現象 | 原因 | 対処 |
|---|---|---|
| インストールや型チェックで React の peer が満たされない | @ui-sdk/react は React 19+ を要求する | react と react-dom を 19 以上にする。TypeScript 利用時は @types/react も 19.2.10 以上にする |
| @ui-sdk/react だけ入れて import や実行に失敗する | @ui-sdk/core は peer 依存で、公式は両方を入れて core を一つに揃えるよう求めている | npm install @ui-sdk/core を追加する |
| Cannot find module '@ui-sdk/react' や、欲しいコンポーネント名が見つからない | 公式はルートの一括エクスポートはないとし、コンポーネントは個別エントリから import する | import { Dialog, DialogTrigger } from "@ui-sdk/react/dialog" のように書く |
| Agent が ui-sdk skill に沿わない、またはドキュメントを見つけられない | skill がそのクライアントの読む場所にない、あるいは AGENTS.md が同梱の llms.txt を指していない | npx skills add vercel-labs/ui --skill ui-sdk を再実行し、公式どおり AGENTS.md を更新する。または node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md を直接指す |
| Codex がモデル不存在と出すが、書いたモデルは掲載済み | base_url が https://api.aicodewith.ai/v1 になっている | https://api.aicodewith.ai/chatgpt/v1 に直す |
| ビルドは通るが、Clear が出ない、またはフォーカスが入力に戻らない | 公式例どおりに present / createFocusRecovery をつないでいない、または Clear が同じ primitive の Root に入っていない | 公式 search-field 例の present、press、bind と照合する |
| 小さなバージョンアップのあと、覚えていたドキュメントと API が合わない | 現在は beta で、公式は API がまだ変わると書いている | サイトだけではなく、入れた版の node_modules/@ui-sdk/*/docs/ の同梱ドキュメントを見る |
FAQ
UI SDK は普通のコンポーネントライブラリと何が違うのか?
公式ドキュメントによれば、振る舞いはフレームワーク非依存の @ui-sdk/core にあり、アダプターは描画だけを担当します。Select、Dialog、Tabs、Rating などの既製コンポーネントも同じ振る舞いの上に乗っており、スタイルなしで、provider もポータルも不要です。既製コンポーネントを使わず、definePrimitive だけで画面を組むこともできます。
React 必須か?
必須ではありません。公式は Vue、Svelte、Solid、Web Components のアダプターも出しています。今回の実測は React 19.3.1 の経路です。他のフレームワークは公式ドキュメントどおりパッケージを差し替えてください。それらのフレームワークでは、今回ビルドを再実行していません。
Agent に skill は必須か?
必須ではありません。公式は、Agent が skills に対応していれば npx skills add vercel-labs/ui --skill ui-sdk を使い、対応していなければ node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md や同梱の llms.txt を指せばよいとしています。インストール後、どちらのファイルも存在することを確認しました。
beta を本番で使ってよいか?
公式ドキュメントは beta であること、API がまだ変わること、そして Vercel Public Beta Agreement を示しています。本番利用するかどうかは、この条項とご自身のリスク判断によります。本稿はインストール、ビルド、Agent によるコンポーネント生成で見た結果だけを記録しています。
今回 Cursor を実行しなかった理由は?
インストーラーは Cursor を skill の対象に含めていましたが、Cursor 内で生成タスクは開始していません。本文の Cursor 設定は本サイトの通常の書き方に沿ったもので、今回の実行では確認していません。
本サイトのモデルで Claude Code や Codex を走らせる場合は、先に API Key を作成できます。



