> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delixon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI reference

> Comandos disponibles en nexenv

`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.

<Note>
  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.
</Note>

## 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).

## Sistema y catalogo

* `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; reportarlo al equipo de Delixon Labs.