CLI

8pt CLI 在终端里搜索并安装组件、模板、主题、图标和 Skill，也能把 8pt 设计规范写进项目、给 Claude Code、Codex 装上 8pt Skill。

#安装与登录

终端

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

npm 包名是 @8pt-dev/cli，装好后的命令是 8pt。不想全局安装时用 npx @8pt-dev/cli <命令>：

不安装直接用

npx @8pt-dev/cli search "定价切换"

8pt login 会打开浏览器，在 8pt 创建 API Key 并保存到本机。在 CI 或脚本里可以跳过登录，用 --api-key <key> 或环境变量 API_KEY_8PT。需要 Node.js 18 或更高版本。

#锁定 8pt 审美

项目根目录

8pt init

8pt init 把 8pt 设计规范写进 AGENTS.md、CLAUDE.md、.cursor/rules/8pt.mdc 和 .github/copilot-instructions.md，可以重复运行更新。之后模型做任何界面都会先查 8pt，只用 8pt 的模板、组件和主题。8pt design <需求> 按需求给出设计规则和匹配的模板、组件清单，8pt rules 打印规范全文。

#常用命令

命令	作用
`8pt search <描述>`	搜索组件（中文或英文）
`8pt add <slug>`	把组件装进 components/8pt/<slug>/，含源码和接入提示词
`8pt prompt <slug>`	打印组件的接入提示词
`8pt templates` / `8pt template <slug>`	列出或取回模板
`8pt skills` / `8pt skill <slug>`	列出或安装 Skill，可用 --target 选 claude、codex、cursor、agents
`8pt theme [slug]`	取回主题变量，--out 写入文件
`8pt icons <名称>`	取回图标 SVG，--out 写入目录
`8pt init` / `8pt design <需求>` / `8pt rules`	写入、查询或打印 8pt 设计规范
`8pt install-skill`	给 Claude Code / Codex 装上 8pt Skill
`8pt mcp [claude\|codex\|cursor]`	打印 MCP 配置
`8pt status` / `8pt logout`	查看或清除本机登录