← Wiki

Agent-Native — One Action, Every Surface

BuilderIO/agent-native is Builder.io’s open-source framework for apps where the AI agent and the UI are equal citizens of one system, not two layers bolted together. Their one-line thesis: “agents that act inside real apps, not just chat next to them. Every action works both ways: click it or ask for it.”

The core pattern: unified actions

The whole framework rests on one move — you define an action once, and it serves every surface: UI buttons, the agent’s tool list, an HTTP endpoint, an MCP server, an A2A (agent-to-agent) call, and the CLI. No separate REST controller, no separate tool schema, no separate CLI command that all drift out of sync. The action is the contract, and the six surfaces are projections of it.

This is the architectural inverse of the common “chatbot in a sidebar” pattern, where the agent calls APIs the UI also calls, and you maintain two parallel code paths that disagree over time. Here there’s one path. State is SQL-backed (Drizzle ORM), so “one database, one state — changes from either side show up instantly.” The agent knows what the user is currently viewing (context-aware), can tag and coordinate with other agents, and can even add features / fix bugs / refine the UI over time (self-improving).

Distribution model: clone, don’t scaffold

Builder.io ships production templates (Clips, Plans, Design, Content, Slides, Analytics) that are “cloneable, not scaffolded — except you own the code.” The flagship is Clips — an open-source, self-hostable Loom replacement where an agent reads a video straight from its URL (full audiovisual content, not just the transcript); it’s the clearest proof of what the framework buys you. Backend-agnostic (any Nitro-compatible host). It also exposes “skills” that plug into Claude Code, Cursor, and Copilot (visual planning, PR recap), so the framework meets you inside the agent harness you already run.

How it relates to what’s in the wiki

Why it matters for solo builders

The unified-action idea is a real DRY win for the kind of app a solo dev ships: you’d otherwise hand-write the button handler, the API route, the MCP tool, and the CLI command four times. If the framework delivers, the cost of “make this app agent-operable” drops to near zero — the agent gets every capability the UI has, for free, the moment you define it once. The open question (unverified here) is lock-in: how much of your app’s shape the action abstraction dictates, and how cleanly you can leave.

Sources

Related