@cowave-front/cli

@cowave-front/cli 是 Cowave Front CLI 的命令行入口，发布后提供 cowave-front 命令。

安装

全局安装：

npm install -g @cowave-front/cli

也可以使用 pnpm：

pnpm add -g @cowave-front/cli

一次性使用：

npx @cowave-front/cli create demo

命令

cowave-front create

创建 Vue 前端项目。

cowave-front create <project-name>

常用示例：

cowave-front create demo --style orca --no-install -y

cowave-front create demo-full --style deep-blue-tech --features i18n,x6,openlayers --ai-skills --ai-tools codex,claude,cursor --no-install -y

选项：

| 选项 | 说明 | | --- | --- | | --style <style> | UI 风格，支持 orca、deep-blue-tech、green-tech | | --features <features> | 可选能力，逗号分隔，支持 i18n,x6,openlayers | | --install | 创建完成后立即安装依赖 | | --no-install | 创建完成后不安装依赖 | | --package-manager <name> | 安装依赖使用的包管理器，支持 npm、pnpm、yarn，默认 npm | | --api-proxy-target <url> | 生成项目中 /api 代理目标地址 | | --ai-skills | 创建完成后安装默认 AI 规则 | | --no-ai-skills | 不安装 AI 规则 | | --ai-tools <tools> | AI 工具列表，逗号分隔 | | -y, --yes | 使用默认值跳过交互 | | -f, --force | 目标目录非空时继续写入 |

cowave-front ai sync

把项目 .ai/rules 同步成不同 AI 工具的入口文件。

cowave-front ai sync --cwd .\demo --tools codex,claude,cursor

选项：

| 选项 | 说明 | | --- | --- | | --cwd <dir> | 需要同步 AI 规则的项目目录 | | --tools <tools> | AI 工具列表，支持 codex,claude,gemini,cursor,windsurf,copilot |

内置资源

发布包包含：

• dist：CLI 构建产物。
• templates/vue-vite：Vue 3.5 + TypeScript + Vite 基础模板。
• templates/styles：不同 UI 风格主题变量。
• templates/features：i18n、OpenLayers 等可选能力模板。
• templates/ai-skills/default：跨 AI 工具规则模板。

prepack 会自动执行 scripts/copy-cli-assets.mjs，把仓库根目录 templates/ 同步到 CLI 包内。

本地开发

在仓库根目录执行：

npm run build
npm run cowave-front -- --help
npm run cowave-front -- create demo-local --style orca --no-install -y

单独构建 CLI 包：

corepack pnpm --filter @cowave-front/cli build

检查发布包内容：

cd packages\cli
npm pack --dry-run

更多文档

• 脚手架使用文档
• npm 发布流程
• 本地测试流程