@kmlckj/licos-ai-cli

LICOS AI 编码工作区 CLI 工具，提供基于前端、移动端和智能体技术栈的项目初始化和开发工具链。

特性

• 快速初始化: 一键创建预配置的项目模板
• AI 优先设计: 专为 AI Agent 消费设计，提供清晰的错误信息和自描述能力
• 多模板支持: 支持 React、Next.js、Vite、Nuxt、Taro、Expo、LangGraph Agent 等多种技术栈
• 类型安全: 基于 JSON Schema 的参数校验
• 命令代理: 统一的 dev/build/start 命令，抹平不同技术栈差异

安装

npm install -g @kmlckj/licos-ai-cli

使用

初始化项目

licos init --template nextjs --app-name my-app

查看可用模板

licos init --help

开发命令

# 启动开发服务器 (读取 .licos 中 [dev].run)
licos dev

# 构建生产版本 (读取 .licos 中 [deploy].build)
licos build

# 启动生产服务器 (读取 .licos 中 [deploy].run)
licos start

模板参数

每个模板都有自己的参数配置，通过 CLI 参数透传。参数名使用 kebab-case 格式，会自动转换为 camelCase 传入模板配置。

例如：

• --app-name -> appName
• --use-typescript -> useTypeScript
• --port -> port

项目配置 (.licos)

项目根目录的 .licos 文件 (TOML 格式):

[project]
requires = ["nodejs-24"]
template = "nextjs"

[dev]
build = ["bash", "./scripts/prepare.sh"]
run = ["bash", "./scripts/dev.sh"]

[deploy]
build = ["bash", "./scripts/build.sh"]
run = ["bash", "./scripts/start.sh"]

可用模板

| 模板 | 说明 | |------|------| | vite | 轻量级 SPA，纯前端 | | nextjs | 全栈应用，Next.js + shadcn/ui | | nuxt-vue | Vue 3 + Nuxt，服务端渲染 | | taro | 小程序 + H5 跨端 | | expo | React Native 移动端 | | agent | Python + LangGraph/LangChain 智能体 | | native-static | 纯静态 HTML/CSS/JS |

开发模板

模板结构

template-name/
├── template.config.js        # 模板配置
├── .licos                    # 项目配置文件
└── src/                      # 源代码（支持 EJS 模板）

参数定义

使用 JSON Schema 定义模板参数：

export const paramsSchema = {
  type: 'object',
  properties: {
    appName: {
      type: 'string',
      minLength: 1,
      pattern: '^[a-z0-9-]+$',
      description: 'Application name'
    },
    port: {
      type: 'number',
      default: 5000,
      minimum: 1024,
      maximum: 65535,
      description: 'Development server port'
    }
  },
  required: ['appName'],
  additionalProperties: false
};

许可证

MIT