The UI kit for AI products.
Every screen your AI product needs: agent views and chat, app screens, marketing sections and backgrounds. React and Tailwind, copied into your repo with the shadcn CLI.
Docs · Components · Blocks · Pricing
- One run store, every view. Feed agent events into one run; the graph, lanes, traces, approvals and chat all read it and stay in sync.
- You own the source. It is a shadcn registry, not a package: the CLI copies each component into your project. Tailwind CSS v4 and the shadcn/ui theme tokens.
- AI-ready. An MCP server and plain-text docs let Claude Code, Cursor and VS Code find, read and install components for you.
import { createAgentRun } from "@/lib/knowns/run";
import { AgentGraph } from "@/components/ui/knowns/agent-graph/agent-graph";
const run = createAgentRun();
run.emit({ type: "actor", actor: { id: "lead", type: "agent", label: "Orchestrator", root: true } });
run.emit({ type: "actor", actor: { id: "web", type: "tool", label: "Web search" } });
run.emit({ type: "span.start", id: "s1", from: "lead", to: "web", summary: "pricing linear.app" });
export default function Run() {
return <AgentGraph run={run} />;
}Events can come from your own code, a replay, or an adapter for your agent SDK. Every view takes run={run}.
Requires React 19, Tailwind CSS v4 and a shadcn components.json (run npx shadcn@latest init if you have none).
npx shadcn@latest add https://ui.knowns.dev/r/agent-graph.jsonOnce Knowns UI is listed in the shadcn registry index you can also use the namespace:
npx shadcn@latest add @knowns-ui/agent-graphRegistry dependencies (the core types, the run store, icons) come along automatically.
- Agent views: graph, lanes, trace waterfall, context window, tool calls, approvals, plans, monitors, fleets, handoffs and cursors.
- Chat: composer, message actions, thinking state, token stream and AI answers.
- Base components: actions, forms, overlays, navigation, data display and feedback.
- Page blocks: hero and marketing sections, site header and footer, sidebar, app shell, auth, settings, blog, docs and error pages.
- Motion: backgrounds, text animation and illustrations.
Browse them all, with live examples and the install command for each: Components · Blocks.
Knowns UI Pro adds, on the same run store:
- Blocks: an Agent Ops dashboard, a Chat App screen, a Kanban board, the Agent Globe, page headers, task detail and pricing sections.
- SDK adapters: turn the Claude Agent SDK, the Vercel AI SDK or the OpenAI Agents SDK stream into run events, server to browser.
- More motion: animated illustrations, backgrounds and text animations.
- Semantic docs search in the MCP server, and Pro updates for life.
Connect your coding agent to the Knowns UI MCP server (https://ui.knowns.dev/mcp), point it at one component's JSON (https://ui.knowns.dev/r/<name>.json), or give it the docs as text (https://ui.knowns.dev/llms.txt). Setup for Claude Code, Cursor, VS Code and Codex: https://ui.knowns.dev/docs/ai-and-mcp
Issues and pull requests are welcome. See CONTRIBUTING.md for how changes flow back into a release.
bun run build # shadcn build: registry.json to public/r
bun run check # installs every item into a fresh Next.js app and type-checks itMIT for the code. See LICENSE.
The model and tool logos in registry/knowns/lib/knowns/icons are trademarks of their owners. They are not covered by the MIT license, are here only to identify those products, and may not be used commercially or to suggest endorsement. Sources and terms: LICENSES.md.
