Skip to content

README.md

Latest commit

 

History

History
210 lines (155 loc) · 6.3 KB

README.md

File metadata and controls

210 lines (155 loc) · 6.3 KB

AI Dev OS CLI

CI npm version License: MIT

Configura, actualiza y diagnostica AI Dev OS con un solo comando.

npx ai-dev-os init --rules typescript --plugin claude-code

¿Que hace?

Configuracion manual Con CLI
git submodule add x 3 repos npx ai-dev-os init (un comando)
Copiar plantilla manualmente Copiado automatico
Fusionar hooks.json manualmente Fusion automatica (con respaldo)
Verificar submodules manualmente npx ai-dev-os doctor
Actualizar submodules manualmente npx ai-dev-os update

Inicio rapido

Modo interactivo

npx ai-dev-os init

El CLI le guiara para seleccionar un preset de reglas y un plugin:

  AI Dev OS Setup
  ───────────────

  ? Select rules preset:
  ❯ TypeScript (Next.js)
    Python (FastAPI)

  ? Select plugin:
  ❯ Claude Code
    Kiro
    Cursor

  ✔ Added submodule: .ai-dev-os/core
  ✔ Added submodule: .ai-dev-os/rules
  ✔ Added submodule: .ai-dev-os/plugin
  ✔ Copied template → CLAUDE.md
  ✔ Merged hooks → .claude/settings.json
  ✔ Created .ai-dev-os.yaml

  Done! Next steps:
    1. Edit CLAUDE.md to customize for your project
    2. Run /ai-dev-os-init in Claude Code to generate L1/L2
    3. See: https://github.com/yunbow/ai-dev-os#quick-start

Modo no interactivo

npx ai-dev-os init --rules typescript --plugin claude-code -y

Comandos

Comando Descripcion
ai-dev-os init Agregar submodules, copiar plantillas, fusionar hooks
ai-dev-os update Actualizar submodules a la ultima version o version fijada
ai-dev-os doctor Verificar estado de instalacion (7 verificaciones)
Detalles de comandos

Update

# Actualizar todos los submodules a la ultima version
npx ai-dev-os update

# Verificar actualizaciones sin aplicar
npx ai-dev-os update --check

# Fijar a una version especifica
npx ai-dev-os update --ref v1.3.0

Doctor

npx ai-dev-os doctor

Verificaciones:

  • Validez del repositorio Git
  • Configuracion de .ai-dev-os.yaml
  • Inicializacion de submodules (core, rules, plugin)
  • Existencia de archivos de plantilla
  • Estado de integracion de hooks
Opciones 
Usage: ai-dev-os init [options]

Options:
  --rules <name>   Preset de reglas (typescript | python)
  --plugin <name>  Plugin (claude-code | kiro | cursor)
  --ref <tag>      Fijar a una etiqueta de version especifica (por defecto: "latest")
  --no-hooks       Omitir fusion de hooks.json
  --dry-run        Mostrar lo que se haria sin ejecutar
  -y, --yes        Omitir prompts interactivos, usar valores por defecto
Archivo de configuracion

El CLI crea .ai-dev-os.yaml en la raiz de su proyecto:

version: "1.0"
core:
  repo: https://github.com/yunbow/ai-dev-os
  ref: latest
  path: .ai-dev-os/core
rules:
  name: typescript
  repo: https://github.com/yunbow/ai-dev-os-rules-typescript
  ref: latest
  path: .ai-dev-os/rules
plugin:
  name: claude-code
  repo: https://github.com/yunbow/ai-dev-os-plugin-claude-code
  ref: latest
  path: .ai-dev-os/plugin
hooks:
  merged: true
  mergedAt: "2026-03-20T10:00:00Z"
Presets disponibles

Reglas

ID Nombre Repositorio
typescript TypeScript (Next.js) ai-dev-os-rules-typescript
python Python (FastAPI) ai-dev-os-rules-python

Plugins

ID Nombre Repositorio Plantilla Hooks
claude-code Claude Code ai-dev-os-plugin-claude-code CLAUDE.md Yes
kiro Kiro ai-dev-os-plugin-kiro AGENTS.md --
cursor Cursor ai-dev-os-plugin-cursor .cursorrules --
Decisiones de Diseño

Lo que hace el CLI

El CLI es un mecanismo de entrega — configura git submodules, copia plantillas y fusiona hooks. No contiene el contenido de reglas ni plugins.

Lo que el CLI NO hace

Decision Razon
Incluir contenido de rules/plugin dentro del paquete CLI Se perderia la transparencia y la capacidad de fork
Reemplazar git submodules con dependencias npm Los proyectos que no usan Node.js no podrian usar AI Dev OS
Hacer el CLI obligatorio "Funciona sin CLI" es un principio de diseño fundamental
Eliminar los repositorios de plugins El CLI es el "mensajero", no el "contenido"
Agregar integracion con GitHub App / OAuth Excesivo — las operaciones git son suficientes

Principio clave

El CLI automatiza lo que podrias hacer manualmente con git submodule add y cp. Si el CLI desapareciera manana, todas las funciones de AI Dev OS seguirian funcionando mediante configuracion manual.

Relacionado

Repositorio Descripcion
ai-dev-os Framework principal
rules-typescript Guias de TypeScript / Next.js
rules-python Guias de Python / FastAPI
plugin-claude-code Integracion con Claude Code
plugin-kiro Integracion con Kiro
plugin-cursor Integracion con Cursor
benchmark Benchmark cuantitativo — datos de impacto de guias

Licencia

MIT

Idiomas: English | 日本語 | 简体中文 | 한국어 | Español