Sintaxis, flags y ejemplos reales para cada comando de DataForge CLI.
dataforge scan [ruta]Recorre recursivamente el proyecto, extrae el contexto de código y consulta al motor de IA activo para generar un reporte integral de arquitectura, riesgos y sugerencias. Se guarda en Markdown dentro de dataforge-reports/.
dataforge explain [archivo]Explica en detalle qué hace un archivo específico: propósito, estructura y decisiones de diseño probables.
dataforge map [ruta]Genera un mapa ASCII de la arquitectura del repositorio: cómo se conectan los módulos entre sí.
dataforge ask [ruta]Abre un chat interactivo con el contexto completo del proyecto cargado. Escribe salir para terminar la sesión.
dataforge onboard [ruta]Genera una guía de onboarding: resumen del proyecto, punto de entrada, archivos críticos y primeros pasos.
dataforge welcomeAbre la carta de bienvenida de DataForge CLI en el navegador.
dataforge setupAsistente interactivo para configurar o reconfigurar tu instalación: proveedor de IA, API key, idioma (es/en) y tema visual.
Free — proveedor fijo en Groq + idioma + tema por defectoPro — desbloquea los temas: Dark, Light, Tokyo Night, DraculaTeams — desbloquea selector de proveedor: OpenAI, Gemini, Claude, OllamaSi no hay licencia activa para una opción, setup la oculta en vez de mostrarla deshabilitada — nunca regala funciones de pago.
dataforge doc++ [ruta]Genera documentación de nivel producción: README, DOCUMENTATION.md, guía técnica, instalación, arquitectura y dependencias.
dataforge architecture++ [ruta]Genera diagramas Mermaid completos de relaciones entre carpetas, dependencias y flujo interno del proyecto.
dataforge explain [archivo] --junior--junior — explicación paso a paso, sin dar nada por sabido--senior — directo al punto, enfocado en decisiones de diseño--teacher — pensado para enseñar el concepto, no solo el código--manager — enfocado en impacto y riesgo, sin jerga técnicadataforge export [ruta] --md--md — Markdown--txt — texto plano--json — estructurado, para integrarlo a otra herramienta--html — listo para compartir en el navegadordataforge preset onboardingEjecuta automáticamente Scan → Explain → Map → Documentation++ → Architecture++ → Export, en un solo paso.
dataforge license DFORGE-PRO-XXXX-XXXXXActiva tu licencia PRO o Teams localmente. Usa dataforge license status para ver el plan y vencimiento actuales.
Personaliza la firma que aparece en toda la documentación generada, para que salga con la identidad de tu estudio o cliente en vez de la de DataForge.
Cada integrante del equipo puede usar su propia API key. El enrutamiento ya está implementado en el CLI; dataforge setup lo desbloquea solo con licencia Teams activa.
Groq — velocidad pura para scan y askClaude — prosa técnica y arquitectura eleganteOpenAI — precisión lógica estrictaGemini — análisis masivo de contextoOllama — motor local, 100% offlineEl administrador del equipo define presets compartidos (por ejemplo: Architecture → Documentation → Export HTML) para que todos sigan el mismo flujo.
Temas, prompts y presets se comparten entre todo el equipo para mantener consistencia en la documentación de todos los proyectos.
Más allá del "qué hace cada comando": cómo sacarle el máximo provecho a DataForge en tu día a día.
El camino completo: instalar, configurar tu API key y correr tu primer scan.
python main.py y sigue el asistentedataforge scan . en un proyecto realdataforge-reports/Un reporte de scan tiene tres bloques: arquitectura detectada, riesgos encontrados y sugerencias accionables.
askEl chat consultor funciona mejor si le das contexto de intención, no solo preguntas sueltas.
salir y vuelve a abrir ask si cambias de tema — mantiene el contexto enfocadoexplainLa misma pregunta, cuatro respuestas distintas según quién la necesita.
--junior — te estás incorporando al proyecto--senior — vas a tomar una decisión de diseño--teacher — le vas a enseñar el concepto a alguien más--manager — vas a justificar tiempo o riesgo ante alguien no técnicoSi repites la misma secuencia de comandos seguido, un preset te la deja en un solo paso.
dataforge preset onboarding como punto de partidaDespués de tu compra, dos comandos son todo lo que necesitas.
dataforge license DFORGE-PRO-XXXX-XXXXXdataforge license status para confirmar plan y vencimientodataforge setup para desbloquear temas/proveedores según tu planLo que más reportan los usuarios de Early Access, con la causa probable y la solución.
Causa probable: sin conexión a internet, o un firewall/proxy corporativo bloqueando GitHub.
Verifica tu conexión y que puedas abrir github.com en el navegador desde la misma red. Si estás en una red corporativa, prueba el método Git clone o ZIP en su lugar — a veces esos sí pasan por el proxy configurado de git.
Causa probable: Python no está en el PATH del sistema.
Reinstala Python desde python.org marcando la casilla "Add python.exe to PATH" durante la instalación. Si ya lo instalaste sin esa opción, prueba con py en vez de python — el launcher de Windows suele estar disponible aunque el PATH no lo esté.
Causa probable: las dependencias no se instalaron, o se instalaron en otro entorno de Python.
Desde la carpeta dataforge-cli, corre pip install -r requirements.txt. Si tienes varias versiones de Python instaladas, usa python -m pip install -r requirements.txt para asegurarte de instalar en el mismo intérprete con el que vas a correr el CLI.
Causa probable: la ruta apunta a una carpeta vacía, o a una carpeta fuera del proyecto (como una carpeta de sistema).
Confirma la ruta con dataforge scan . parado dentro de la carpeta del proyecto, en vez de pasar una ruta absoluta que podría estar mal escrita. Si el proyecto es válido y sigue sin encontrar nada, revisa que no esté completamente vacío o que los archivos no tengan una extensión no reconocida.
Causa probable: proyecto muy grande (mucho contexto a procesar), o límite de rate en tu API key.
Prueba escaneando una subcarpeta específica en vez de la raíz completa de un repo enorme. Si tu proveedor te devuelve un error de rate limit, espera unos segundos e intenta de nuevo — cada proveedor (Groq, OpenAI, etc.) tiene sus propios límites según tu plan de API, independientes de tu licencia de DataForge.
Causa probable: el código se copió con espacios extra, o no coincide el formato exacto.
El formato debe ser exactamente DFORGE-PRO-XXXX-XXXXX (o TEAMS/ENT según tu plan), sin espacios al inicio o final. Corre dataforge license status para confirmar qué quedó guardado. Si el problema persiste, abre un Issue con el mensaje de error exacto (nunca compartas tu código de licencia completo en un Issue público).