@kevairy/cli
v0.4.1
Published
Command-line tools for Kevairy projects
Readme
@kevairy/cli
Kevairy 命令行工具。当前提供 create 命令,每次从 npm registry 下载 @kevairy/template 后生成一个可以脱离源仓库运行的后台项目。
使用
无需全局安装:
pnpm dlx @kevairy/cli create my-admin也可以全局安装后使用:
pnpm add --global @kevairy/cli
kevairy create my-admin本地使用
pnpm create:app my-admin非交互方式:
pnpm create:app my-admin \
--display-name "My Admin" \
--package-manager pnpm \
--template-version 0.1.0 \
--no-install \
--no-git \
--yes交互模式会显示 Kevairy 品牌启动页、步骤式问答、项目配置预览和创建任务状态。CLI 默认使用所选包管理器自动安装依赖并初始化 Git;如需跳过,可显式传入 --no-install 或 --no-git。在 CI、管道或其他非 TTY 环境中必须指定目标目录并使用 --yes,CLI 会自动输出无动画的逐行日志。
依赖安装和 Git 初始化默认收起子进程日志;创建失败时会保留项目目录并显示关键错误。需要查看完整命令输出时传入 --verbose:
pnpm create:app my-admin --verbose支持 pnpm 10、npm 10 和 Yarn Classic 1.22。默认使用 pnpm,并在安装依赖前保护已有的非空目录。模板默认使用 npm latest;传入 --template-version <version> 可以锁定精确版本。CLI 和依赖安装都会优先复用本机缓存,缓存未命中时再访问已配置的 registry。Yarn Berry 暂不在当前兼容范围内。
生成结构
my-admin/
├── src
├── public
├── tests
├── package.json
└── README.md源码、测试和工程配置都直接位于项目根目录,只生成一层 package.json 和 node_modules。
模板关系
CLI 发布包不包含模板源码。更新 @kevairy/template 后无需重新发布 CLI;创建项目时 CLI 会下载 latest 或命令指定的版本。模板维护流程见 @kevairy/template。
