Skip to main content
Nexenv genera proyectos a traves de engines (motores) que implementan el trait BackendEngine. Esta arquitectura desacopla la UI de los motores: la UI llama generate_scaffold(engine_id, ...) y el registro despacha al engine apropiado.

Engines incluidos

  • nexenv-manual (Free, default): wrapper sobre los templates locales de Nexenv. No requiere internet ni cuenta externa.
  • qiloback (Free, cliente): cliente HTTP contra platform-api de QiloBack. Auth con Bearer token persistido en ~/.nexenv/engines.toml con permisos 0600.

Conectar QiloBack

Dos formas, ambas guardan el token en ~/.nexenv/engines.toml:
  • App (GUI): Settings → Engines → “Conectar con QiloBack” (device flow: apruebas en el navegador con tu cuenta, sin copiar tokens).
  • CLI / shell: nexenv engines connect hace el mismo device flow desde la terminal. También nexenv engines set --endpoint <URL> --token <TOKEN> para BYOL/CI. El wizard de creación (GUI, nexenv new, nexenv shell/new) ofrece QiloBack y conectar cuando el stack incluye FastAPI.

Decisiones vinculantes

  • ADR-001 — Engine tier: trait, registry, builtins, cliente QiloBack y MCP local son todos Free. El recipe marketplace tiene gating mixto Free/Pro.

Anadir un engine externo

  1. Implementar BackendEngine (async fn generate(&self, request) -> Result<Vec<File>, EngineError>).
  2. Registrar en EngineRegistry::register.
  3. Anadir feature flag o variable de entorno si es opcional.
Mas detalle en vision-roadmap/RFC-001-backend-engine-trait.md.