Introduction
cilo is a shadcn registry of React blocks for products where an agent does part of the work. Every item lands in your project as source files, built on the stock shadcn components you already have, so you read it, change it and own it.
What is in it
- Free blocks
- More than 1,100 blocks in 69 families, from accordion to typography, named b-<family>-<n> and added as @cilo/<name>. Most families open with shadcn's own Base UI examples, then cilo's: tables, charts, approvals, chat, traces.
- Pro blocks
- More than 750 blocks in 121 families, named pb-<family>-<n> and added as @cilo-pro/<name> with your licence key: agent runs, composers, conversations, traces, app shells, and families for finance, dispatch, inspection, power and robots. Many take their content as one typed data prop.
- Pages
- Pro pages (pp-<group>-<slug>) are not published for now. Build a screen from a pro shell and one block per region.
- Plugins
- Components of cilo's own, added as @cilo/<plugin> and installed into components/cilo/<plugin>/: the data table, for records people sort, filter and act on, and the stepper, for multi-step progress and wizards.
- Palettes
- Twelve colour palettes for shadcn's tokens, light and dark: cilo, the default, then greige, neutral, stone, zinc, mauve, olive, mist, taupe, sand, slate and sage. One per project.
A block's source is the same in all eight shadcn styles (nova, vega, maia, lyra, mira, luma, sera, rhea): its look comes from your project's own stock components, and your project’s chosen icon library is swapped in at install. Find blocks with the CLI search described in Installation, or ask your agent through the MCP server.
How it reaches you
You add an item by name with the shadcn CLI, from https://registry.cilo.com. It writes the block to components/cilo/, adds the stock shadcn components it is built on in your project's style, installs its required packages, and swaps its icons for your icon library. From then on the block is yours: no package stands between you and its code. cilo ships no components/ui files of its own, so nothing you already have is replaced.
Your agent can do the same through cilo's hosted MCP server at https://mcp.cilo.com: find items by what they do, read their source, and hand you the one command that installs them. See MCP server.
Set up your agent
Each of the sixteen agents has a page of its own: where its servers live, the command, and how to see that it is connected.
Pick your agentRequirements
- React 19 and Tailwind CSS 4
- shadcn on Base UI: a components.json whose style starts with base-, such as base-nova. Radix and React Aria projects are not supported.
- The shadcn CLI 4.7 or newer, run as npx shadcn@latest
- Node.js 20.18.1 or newer
- A pro licence key for pro installs, and an MCP access key for MCP tool calls
Blocks install into any such project. One command sets up a new project with all of it; see Installation.
Where to start
- Installation
- Set up a project, add both registries with your licence key, the palette, and your first blocks by hand.
- MCP server
- Connect your agent to the hosted server, then ask it for blocks by what they do.