@21st-dev/cli weekly downloads statistics

21st CLI

Search, retrieve, install and publish 21st.dev components, themes and templates from your terminal, generate UI with 21st AI, and wire the 21st MCP into your editor. The CLI and the 21st MCP share one endpoint and one login, so every command returns exactly what an MCP client (Cursor, Claude, etc.) sees.

One unified CLI. @21st-dev/cli (bin 21st) is now the single tool for everything 21st. It supersedes the older @21st-dev/registry (publish/install) and @21st-dev/magic (Magic MCP) packages — use 21st for all of it. Old @21st-dev/magic configs keep working: since 0.2.0 that package is a thin proxy to the same 21st MCP endpoint this CLI configures.

Install

Sign in

You can also authenticate with an API key from https://21st.dev/settings/api-keys via the TWENTYFIRST_TOKEN (or API_KEY_21ST) env var, or the --api-key / --token flag. A retired an_… key left in an env var is skipped so it can't shadow a working 21st login session.

Commands

| Command | What it does |

| 21st search [--type component\|theme\|template] [--context auto\|path] [--tag] [--color] [--sort] [--json] | Search metadata; Design Context adds confidence and fit rationales. | | 21st logo [--limit N] [--json] | Search brand + UI SVG logos. Free, no login required. | | 21st get [--json] | Print one component's code + demo by its search id (metered). | | 21st theme [--json] | Print one theme's CSS by its search id — free. | | 21st add / [--print] | Install a component via the 21st shadcn registry. | | 21st bookmarks [--type ...] [--limit N] / 21st bookmark --type [--remove] | List / add / remove a bookmark ("heart") across any entity. | | 21st lists / 21st list / 21st list-new / 21st list-add --type [--remove] | Manage named bookmark lists. | | 21st teams / 21st team / 21st team-lists / 21st team-components [--library ] | Browse your teams' shared libraries + lists. | | 21st components [--status all\|draft\|published\|private] [--scope all\|personal\|team:] [--json] | List every accessible personal/Team component and owned draft, using stable refs. | | 21st open \|draft:> [--no-open] | Resume a draft or create/resume a reviewed revision of an existing component; --no-open prints its URL. | | 21st publish [--component component:] --description "…" [--to ] [--preview ] [--no-open] | Create a draft, open CLI Review with live demos and automatic media, then publish a new component or an explicit owned revision. | | 21st submit / withdraw / resubmit / remove-from-catalog | Manage catalog review separately from Published/Private access. | | 21st publish-theme --name "…" [--tags a,b] | Publish a theme (CSS with :root + .dark). | | 21st publish-template --site --preview [--price N] | Submit a template listing for review. | | 21st publish-gradient --name "…" --thumbnail | Publish a Gradient Builder recipe to the API key's scope. | | 21st publish-ascii --name "…" --thumbnail [--video ] [--mask ] [--private] | Publish an ASCII recipe to the API key's scope. | | 21st edit component: --type component [...] / 21st delete component: --type component --yes | Edit or unpublish the exact component returned by inventory, including manageable team components. | | 21st edit --type [...] / 21st delete --type --yes | Edit or remove a theme/template using its existing API-key-scoped id semantics. | | 21st delete draft: --type draft --yes | Permanently delete an owned draft and its unpublished sandbox. | | 21st publish --prepare [--wait-video] [--media-dir ] / 21st publish --draft draft: --auto [--wait-video] | Headless flow: prepare revision-bound media without publishing, then publish that exact draft entirely from the CLI. | | 21st profile get [--json] / 21st profile set --file [--clear] / 21st profile upload | Read, replace, or clear your bento profile board and upload media for it (requires a 21st_sk_… API key). | | 21st inspiration-feedback --outcome accepted\|rejected | Record a privacy-safe inspiration decision. | | 21st generate "" [--context auto\|path] [--variants N] | Generate grounded alternatives with hosted 21st AI access and AI credits, then open their preview. | | 21st generation / 21st iterate "" [--take N] / 21st take [--take N] [--code] [--select] | List a sketch generation's takes, refine one, and grab its code (generation/take are free). | | 21st init --design-context [--check\|--refresh] | Create or verify .21st/design.json and .21st/DESIGN.md. | | 21st review [--fix] [--json] | Run deterministic local UI review and conservative fixes. | | 21st skills install\|list\|check\|update\|remove | Manage verified skills for Claude, Cursor, and Codex. | | 21st skills catalog | Inspect curated compatibility; broad discovery stays on skills.sh. | | 21st install-skill | Compatibility alias for 21st skills install --global. | | 21st init --client [--write] | Print or write the 21st MCP config for an editor. | | 21st login / logout / whoami / usage [--json] | Manage your local session and see retrieval quota plus hosted AI access. |…

Description from the npm listing.