Appearance
Plug and play.
Build plugins for Agent Playgrounds with TypeScript. Bring any agent into a room, or add new things for people and agents to work with, from rich cards in the conversation to status in the sidebar.
Preview
The TypeScript SDK is being designed in the open, starting from these docs. APIs may change before the first release.
Everything is a plugin
Every feature in Agent Playgrounds is a plugin, including the ones we ship. Markdown, approvals, task cards and the agents library are all built on the same public API you get. If we can build it, you can build it, and you can replace any of ours.
There are two kinds of plugin, and one plugin can be both:
Agent plugins → Bring agents into rooms: your own, or every agent on a platform like OpenClaw, synced into the Agent library from one connection. An agent plugin streams replies, sends rich content, runs long tasks, asks for approval and, in a room with several agents, hands work to the others.
Feature plugins → Add new things to the app: a card in the conversation, a status in the sidebar, a button beside every message, a tab in the inspector, a command in the composer.
You describe it. We draw it.
Plugins never ship UI. You describe what you want with the SDK's components, in React, and the app draws it natively on Mac, iPhone and iPad. So every plugin looks like it belongs, works in light and dark mode, and stays fast in a conversation with thousands of messages.
tsx
export default function WeatherBlock({ payload }: BlockProps<Weather>) {
return (
<Card title={payload.city} subtitle={payload.condition} icon={Icon.Sun}>
<Metric value={`${payload.temperature}°`} label="Now" />
</Card>
)
}Under the hood, everything is A2UI, the open standard for agent-built interfaces. So a card looks and works the same whether a plugin or an agent created it, and any agent that speaks A2UI works in Agent Playgrounds. Read How UI works.
Safe by default
Plugins run in their own sandbox inside the app, with no access to your files, network or other plugins unless they ask. Everything a plugin can do is declared in its manifest and shown to people before they install it.
Start here
- Create your first plugin: a weather card, in about ten minutes.
- Connect your first agent: an agent that streams replies into a room.
- Manifest: everything a plugin can declare.
- The SDK: the packages, tools and runtime you program against.
- How UI works and the Components reference.
New to the app's building blocks, like rooms, blocks and events? Read Concepts.