> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launcherforge.io/llms.txt
> Use this file to discover all available pages before exploring further.
# CLI de Launcher Forge
> Descarga, ejecuta, autentica y utiliza la CLI interactiva de Launcher Forge.
# CLI de Launcher Forge
La CLI de Launcher Forge es una aplicación interactiva para Windows utilizada para publicar builds empaquetadas de un juego.
El programa guía todo el flujo mediante menús y preguntas. No necesitas construir comandos de despliegue ni utilizar parámetros manuales.
La CLI es un ejecutable portable. No requiere un proceso de instalación. Puedes guardarla en el escritorio o en otra carpeta y ejecutarla directamente.
## Qué permite hacer
La CLI permite al desarrollador:
* Autenticarse con una cuenta de desarrollador de Launcher Forge.
* Revisar el uso y los límites del workspace.
* Listar los juegos disponibles.
* Consultar versiones publicadas.
* Publicar una build en una rama.
* Revisar la versión instalada de la CLI.
* Cerrar la sesión local mediante Logout.
La CLI utiliza credenciales de desarrollador. Las cuentas de jugadores del launcher no pueden utilizarse para publicar builds.
## Descargar la CLI
Abre el dashboard de Launcher Forge y selecciona **CLI** en el menú lateral.
Selecciona el juego que deseas revisar y abre su página de publicación mediante CLI.
La página muestra:
* Application ID.
* Cantidad de ramas.
* Rama predeterminada.
* Estado de acceso a la CLI.
* Descarga de la CLI para Windows.
* Resumen del flujo interactivo.
Selecciona **Download CLI**.
## Ejecutar la CLI
Después de descargar el ejecutable:
1. Muévelo al escritorio o a otra carpeta.
2. Abre el ejecutable directamente.
3. Mantén abierta la ventana mientras utilizas la CLI.
No existe un asistente de instalación ni debes instalarla localmente.
Descarga un ejecutable nuevo cuando Launcher Forge publique una nueva versión. Utiliza **Version info** para consultar la versión que estás ejecutando.
## Autenticación
Cuando no existe una sesión local válida, la CLI solicita el correo y la contraseña de la cuenta de desarrollador.
Utiliza la misma cuenta que tiene acceso al workspace y a los juegos que deseas publicar.
Después de iniciar sesión correctamente, la CLI conserva una sesión local para evitar solicitar las credenciales cada vez que se abre.
### Cuentas creadas mediante OAuth
Cuando la cuenta fue creada mediante Google, GitHub u otro proveedor OAuth, la CLI igualmente necesita correo y contraseña.
Configura una contraseña para la cuenta de Launcher Forge antes de intentar iniciar sesión mediante la CLI.
No compartas la CLI junto con los datos de la sesión local. Utiliza **Logout** antes de usarla en un computador compartido.
## Resumen de la cuenta
Después de autenticarse, la CLI muestra un resumen.
Puede incluir:
* Correo del desarrollador.
* Plan actual.
* Estado de la cuenta.
* Almacenamiento utilizado y disponible.
* Ancho de banda utilizado y disponible.
* Juegos utilizados y permitidos.
Esta información ayuda a confirmar que la cuenta y los límites correctos están activos antes de publicar.
## Menú principal
La CLI presenta un menú interactivo.
| Opción | Función |
| ------------------- | ------------------------------------------------------------------------ |
| **Upload build** | Inicia el flujo interactivo para publicar una build. |
| **Account / usage** | Muestra la cuenta, plan, almacenamiento, ancho de banda y uso de juegos. |
| **List games** | Lista los juegos disponibles para la cuenta autenticada. |
| **List versions** | Lista las versiones publicadas de un juego disponible. |
| **Version info** | Muestra información de la versión actual de la CLI. |
| **Logout** | Elimina o invalida la sesión local y vuelve a la autenticación. |
| **Exit** | Cierra la aplicación. |
Utiliza las flechas para seleccionar una opción y presiona **Enter**.
## Publicar builds
La publicación comienza desde **Upload build**.
El flujo solicita:
1. Juego.
2. Rama.
3. Número de versión.
4. Tipo de release.
5. Changelog.
6. Carpeta de la build empaquetada.
7. Ejecutable principal.
8. Confirmación final de la subida.
El procedimiento completo está documentado en una página separada para evitar repetirlo en toda la sección de la CLI.
Sigue el flujo completo, desde la autenticación hasta la confirmación de la subida.
Revisa STABLE, PATCH, HOTFIX, manifiestos, hashes, ejecutables y comparaciones.
## Sesión de la CLI
La sesión de la CLI es independiente de la sesión abierta actualmente en el navegador.
Utiliza **Logout** cuando:
* Quieras cambiar de cuenta de desarrollador.
* Utilizaste un computador compartido.
* La sesión actual dejó de ser válida.
* Aparecen permisos, workspace o juegos incorrectos.
Cerrar la aplicación mediante **Exit** no necesariamente cierra la sesión.
## Qué no hace la CLI
La CLI no permite:
* Crear cuentas de desarrollador.
* Crear juegos en el Catálogo.
* Crear cuentas de jugadores.
* Configurar templates.
* Configurar game keys.
* Generar el instalador del launcher.
* Editar los archivos de una build existente.
* Reemplazar una versión publicada.
Estas tareas se realizan desde el dashboard o mediante una nueva versión.
## Flujo recomendado
```text theme={null}
Crear y publicar la ficha del juego
↓
Configurar la validación launcher-juego
↓
Crear o seleccionar la rama de destino
↓
Empaquetar y probar el juego localmente
↓
Abrir la CLI
↓
Seleccionar Upload build
↓
Completar las preguntas
↓
Revisar la versión desde el dashboard
```
## Guías relacionadas
Resuelve errores de autenticación, permisos, carpetas, ejecutables, almacenamiento y subida.
Crea canales públicos o privados antes de publicar una versión.
Verifica descarga, instalación, actualizaciones e inicio después de publicar.