CLI

The 8pt CLI searches and installs components, templates, themes, icons and Skills from your terminal. It can also write the 8pt design system into your project and install 8pt Skills for Claude Code and Codex.

#Install and log in

Terminal

npm i -g @8pt-dev/cli
8pt login

The npm package is @8pt-dev/cli; once installed the command is 8pt. To skip the global install, use npx @8pt-dev/cli <Command>:

Use without installing

npx @8pt-dev/cli search "pricing toggle"

8pt login opens your browser, creates an API key on 8pt and saves it locally. In CI or scripts you can skip login and use --api-key <key> or the environment variable API_KEY_8PT. Requires Node.js 18 or later.

#Lock in the 8pt look

project root

8pt init

8pt init Writes the 8pt design system into AGENTS.md, CLAUDE.md, .cursor/rules/8pt.mdc and .github/copilot-instructions.md; run it again any time to update. From then on the model checks 8pt before building any UI and uses only 8pt templates, components and themes.8pt design <request> Returns design rules and a matching list of templates and components for a request;8pt rules prints the full rules.

#Common commands

Command	What it does
`8pt search <Description>`	Search components (Chinese or English)
`8pt add <slug>`	Install a component into components/8pt/<slug>/, with source and integration prompt
`8pt prompt <slug>`	Print a component’s integration prompt
`8pt templates` / `8pt template <slug>`	List or fetch templates
`8pt skills` / `8pt skill <slug>`	List or install Skills; --target picks claude, codex, cursor or agents
`8pt theme [slug]`	Fetch theme variables; --out writes a file
`8pt icons <Name>`	Fetch icon SVGs; --out writes to a folder
`8pt init` / `8pt design <request>` / `8pt rules`	Write, check or print the 8pt design system
`8pt install-skill`	Install the 8pt Skill for Claude Code / Codex
`8pt mcp [claude\|codex\|cursor]`	Print the MCP config
`8pt status` / `8pt logout`	Show or clear the local login