Skip to main content
nexenv expone los comandos del backend con paridad respecto a la GUI donde tiene sentido. La fuente de verdad es siempre nexenv --help, que agrupa los comandos en las categorias de abajo.
El comando publico es nexenv (lo expone el wrapper npm @delixon/nexenv, el wrapper pip nexenv y el bundle nativo). Si compilas desde el repo nexenv-core, el binario se llama nexenv-cli — es exactamente el mismo CLI.

​
Proyectos

  • list — lista los proyectos registrados.
  • scan [path] — detecta el stack de un proyecto (por defecto el directorio actual).
  • new [name] — crea un proyecto (sin argumentos abre el wizard interactivo). Flags: --path, --type, --profile, --techs, --starter, --wizard, --no-git, --engine (nexenv-manual por defecto o qiloback), --dsl.
  • register [path] — registra un proyecto existente con scan auditado y editable.
  • edit [project] — edita un proyecto registrado.
  • launch [project] — genera y ejecuta el script de setup local.
  • create <name> — crea desde una plantilla (--template).
  • open [project] — abre el proyecto en el editor configurado.
  • status [project] — estado git del proyecto.
  • health [project] — health checks (puertos, servicios, archivos).
  • manifest [project] / manifest-edit — ver/editar .nexenv/manifest.yaml.
  • file-edit — leer/escribir archivos editables (whitelist segura).
  • unlink <name> — desvincula un proyecto (no borra archivos).
  • prune — detecta y limpia proyectos huerfanos (--yes, --dry-run).
  • project [project] — workbench interactivo de un proyecto.

​
Datos del proyecto

  • env — gestiona variables de entorno (get/list/set/unset).
  • snapshot — versionado del manifest (save/list/diff/rollback/deprecate).
  • diff [project] — cambios de entorno desde el ultimo snapshot.
  • note — notas del proyecto (--add/--edit/--delete/--view).
  • run <script> — ejecuta un script del manifest.
  • add <recipe> — aplica una recipe (--preview).
  • ps [project] — procesos en los puertos del proyecto.
  • export / import — portabilidad del proyecto (.nexenv JSON).
  • doctor — estado del sistema (runtimes, herramientas).
  • ports — puertos en uso y conflictos.
  • catalog [id] — navega el catalogo de tecnologias.
  • starters — starter packs curados (--type). No lista packs con techs no usables.
  • recipes — recipes disponibles (filtra por stack).
  • validate <techs...> — valida una combinacion (dependencias, puertos, incompatibilidades, status planned/deprecated y requires_any).
  • settings — configuracion personal (idioma, editor).
  • update [--run] — muestra como actualizar el CLI segun como se instalo (npm global, pip o paquete de sistema). --run ejecuta la actualizacion (npm install -g @delixon/nexenv@latest o pip install -U nexenv); para instalaciones de sistema remite a la pagina de descarga. Ademas, al final de cada comando el CLI avisa (una linea, cacheada 1×/dia) si hay una version mas nueva, con el comando de upgrade correcto para tu canal.
  • engines list|connect|set|remove — engines de generacion (QiloBack), a la par de Settings → Engines de la app:
    • engines connect [--endpoint URL] — conecta tu cuenta QiloBack por device flow desde la terminal: imprime una URL + un codigo para aprobar en el navegador y guarda el token en ~/.nexenv/engines.toml.
    • engines set --endpoint <URL> --token <TOKEN> — configura endpoint/token a mano (BYOL self-hosted o CI).
    • engines list — estado de los engines; engines remove qiloback — borra la config. El wizard (nexenv new / nexenv shell → /new) tambien ofrece QiloBack y conectar cuando el stack incluye FastAPI, y deja definir el DSL con IA (descripcion → DSL), un archivo, o el ejemplo.
  • qiloback status|dsl|gen [ruta] — gestiona un proyecto QiloBack desde la terminal (paridad con la pestaña QiloBack de la app):
    • qiloback status — estado: DSL en disco + ultima generacion.
    • qiloback dsl [--show | --set <archivo> | --ai "<descripcion>"] — muestra, pone (desde archivo) o genera con IA el DSL.
    • qiloback gen — genera/regenera el backend desde el DSL (crea/reusa el proyecto remoto, sube el DSL, genera y descarga el codigo).

​
Docker

  • docker up|down|status|logs [project] — gestiona docker-compose.

​
Health & fixes

  • health-fix directory|init-git|readme|gitignore|env-example — correcciones automaticas.

​
SQL y REPL embebidos

  • sql connections|test|query — mini consola SQL (detecta conexiones en .env).
  • repl python — REPL Python anclado al directorio del proyecto.

​
Modo interactivo

  • shell — shell interactivo (reedline) con menu live, autocompletado y acciones rapidas.
  • tui — dashboard a pantalla completa (ratatui).

​
Paridad GUI ↔ CLI

sql, repl python, shell, tui y health-fix son deliberadamente solo-CLI. El resto tiene equivalente en la GUI. Si una accion existe en la GUI pero no aparece en nexenv --help, es un bug; abrir issue en delixon-labs/nexenv-core.