# Introduction

A shadcn-style registry of complete, production-ready AI agent recipes. Copy, paste, ship.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available by appending `.md` to any URL or sending an `Accept: text/markdown` header. An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).



**agentcn** is a registry of complete, production-ready agent recipes. It is **not** a UI component registry — each recipe distributes the
backend agent files (instructions, tools, skills, workflows) that you copy
straight into your project with the [shadcn CLI](https://ui.shadcn.com).

## Philosophy [#philosophy]

agentcn follows the shadcn model for backend agents: copy-paste recipes you can
own, with zero lock-in and sensible defaults that work immediately.

Agents are too often shipped as opaque packages — you import a black box and
fight its constraints the moment you need something different. agentcn takes the
opposite approach. You get the full source of each agent and stay close to your
framework's primitives, so you can read every line, swap the model, extend the
tools, or reshape the output without working around a library.

## Why agentcn? [#why-agentcn]

Most agent setups are either too opinionated or too scattered. agentcn is built
for teams that want to ship quickly without giving up control:

* **Own Your Code:** Copy recipes into your project and customize everything.
* **Start Fast:** Run one command and get a working agent with production-ready
  defaults.
* **Scale Safely:** Build on Eve or Flue directly, then drop to the raw
  framework APIs whenever you need more control.

## Frameworks [#frameworks]

Every recipe ships in both flavors where it makes sense, so you can adopt the
pattern in whichever framework you already use:

* **[Eve](https://vercel.com/docs/eve)** — a filesystem-first framework for
  durable backend AI agents that run on Vercel Functions.
* **[Flue](https://flueframework.com)** — an agent runtime with first-class
  subagents, skills, and bounded workflows.

## Features [#features]

<div className="not-prose grid gap-4 sm:grid-cols-2 mt-4">
  <FeatureCard icon="ZapIcon" title="Zero Config" description="Works out of the box with sensible defaults. No boilerplate needed." />

  <FeatureCard icon="SunMoonIcon" title="Framework Native" description="Uses your framework's built-in primitives — no extra abstractions." />

  <FeatureCard icon="LayoutGridIcon" title="Composable" description="Combine agents, tools, and workflows into complex pipelines." />

  <FeatureCard icon="Code2Icon" title="TypeScript" description="Full type safety with comprehensive TypeScript support." />

  <FeatureCard icon="ClipboardCopyIcon" title="Copy & Paste" description="Own your code. No runtime dependencies, just install into your project." />

  <FeatureCard icon="BlocksIcon" title="shadcn Compatible" description="Uses the same registry format — add components with npx shadcn add." />
</div>