Documentation

Install with shadcn CLI

How CLI install works for free and Pro Blocks and AI Components, how tokenized installs are generated, and how to verify a successful install.

Use this path when you want to pull a Block or AI Component into an existing app with one command.

Two install paths

Free Blocks

pnpm dlx shadcn@latest add <block-name>

Pro Blocks and AI Components

The UI generates a tokenized install URL and copies a command like:

pnpm dlx shadcn@latest add 'https://www.aisdkagents.com/pro-registry/<block-name>?token=<short-lived-token>'

The tokenized command is generated from the toolbar so private registry access can be validated first.

Skills

Skills use the Skills CLI, not the shadcn CLI. See Install Skills.

pnpm dlx skills add https://aisdkagents.com/skill/<short-lived-token> --skill <skill-name>

That installs knowledge for an assistant. It does not install Pro Block source files.

What gets added to your project

shadcn add installs Block or component files plus any registry dependencies they reference. If additional npm packages are required, the CLI prompts for them.

Verification checklist

After running the copied command:

  1. Confirm new files exist in your app.
  2. Confirm imports resolve (@/components/*, @/lib/*).
  3. Run type check and lint:
pnpm lint
pnpm typecheck
  1. Start the dev server and open the route that uses the installed Block.

Common failures

401/403 on Pro installs

  • Your account is not entitled to the Block, or
  • The token expired before command execution.

Fix: recopy the command from the Block page and run it immediately.

Command works but UI breaks

  • Usually missing env vars or npm dependencies.

Fix: review the Block page for required environment variables and services.

When to choose this path

  • You already have an app and want specific Blocks or AI Components.
  • You want a small file footprint instead of full project scaffolding.

For Skills, use Install Skills. For full starters, see Templates.