Introduction

Herald UI

Herald is a set of composable, carefully-crafted components for building a personal AI operating system — the whole cockpit, not just a chat bubble bolted onto an app. Free, open source, built on Base UI, and designed to drop into any shadcn/ui project.

This isn't another chatbot widget. It's the kit for your whole AI OS.

You've seen them: personal agent dashboards, AI command centers, home-grown copilots — and most of them look vibe-coded. A chat pane here, a settings screen in a different font there, a fleet view that fights the sidebar. The pieces never feel like one product.

Herald is the fix. Instead of gluing mismatched parts together, you compose blocks that already speak the same language — the shell, the chat surface, agent and fleet views, the command bar — into one coherent, beautiful AI OS. Think of it as Lego for AI operating systems: snap the pieces together, then make it yours.

Herald is built around a few principles:

• Open Code: The source lives in your repo, open for modification. No black-box package to fight.
• Composition: Every block shares the same typed contracts, so they snap together predictably.
• Distribution: A flat-file registry and npx shadcn add make components trivial to pull in.
• Beautiful Defaults: Crafted styling out of the box — and one hue re-themes the entire system.
• AI-Native: Chat, tool calls, streaming, and agent surfaces are first-class, not afterthoughts.