> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/es/referencia/cli.md).

# Interfaz de línea de comandos

Todos los comandos de la línea de comandos, opciones, parámetros de inicio, variables de entorno, vínculos profundos y modificadores del instalador de UniGetUI.

El comando `unigetui` controla una sesión de UniGetUI en ejecución desde un terminal o un script: buscar, instalar, actualizar y quitar paquetes, administrar la configuración, los orígenes, los lotes y las copias de seguridad, y leer los registros. La CLI se comunica con la sesión a través de la [API de automatización](/unigetui/es/referencia/ipc-api.md) local.

{% hint style="info" %}
Si `unigetui` no se reconoce en su shell, ejecute en su lugar el ejecutable de UniGetUI desde su carpeta de instalación, por ejemplo `UniGetUI.exe` en Windows.
{% endhint %}

## Requisitos

La CLI necesita una sesión de UniGetUI a la que conectarse:

* **Sesión de escritorio**: UniGetUI está abierto o en ejecución en el área de notificación, y ***Habilitar API en segundo plano (Widgets de UniGetUI y Compartir, puerto 7058)*** está activado en ***Configuración*** – ***Ajustes experimentales y opciones de desarrollador***.
* **Sesión sin interfaz**: UniGetUI se inició con `--headless`. Consulte [Sesiones sin interfaz](#headless-sessions).

Si no se puede alcanzar ninguna sesión, el comando termina con el código `3`.

## Inicio rápido

```powershell
unigetui status
unigetui app status
unigetui package search --manager dotnet-tool --query dotnetsay
unigetui package install --manager dotnet-tool --id dotnetsay --version 2.1.4 --scope Global
unigetui operation wait --id 123 --timeout 300
```

## Sintaxis

* Los nombres aceptan el singular o el plural: `operation`/`operations`, `package`/`packages`, `manager`/`managers`, `source`/`sources`, `shortcut`/`shortcuts`, `log`/`logs`, `backup`/`backups`, `bundle`/`bundles`.
* `startmenu` se acepta en lugar de `start-menu`, y `folders` en lugar de `folder`.
* Las opciones booleanas toman un valor explícito: `--enabled true`, `--wait false`.
* `--detach` es la forma abreviada de `--wait false` en las operaciones de paquetes. El comando devuelve de inmediato un identificador de operación.
* Alias:
  * `--id` corresponde a `--package-id` o a `--operation-id`, según el comando.
  * `--source` corresponde a `--package-source`.
  * `--source-name` y `--source-url` corresponden a `--name` y `--url` en `source add` y `source remove`.
  * `--name` corresponde a `--key` en `backup cloud download` y `backup cloud restore`.
* `--manager` toma un identificador de gestor estable, no el nombre que se muestra en la aplicación: `apt`, `bun`, `cargo`, `chocolatey`, `dnf`, `dotnet-tool`, `flatpak`, `homebrew`, `npm`, `pacman`, `pip`, `pwsh`, `scoop`, `snap`, `vcpkg`, `winget`, `winps`. Solo funcionan los gestores de la plataforma actual. Consulte [Gestores de paquetes compatibles](/unigetui/es/referencia/package-managers.md).

## Opciones de conexión

De forma predeterminada, la CLI encuentra por sí sola la sesión en ejecución. Use estas opciones para dirigirse a una en concreto.

<table><thead><tr><th width="250">OPCIÓN</th><th>VARIABLE DE ENTORNO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transporte usado para llegar a la sesión. Predeterminado: <code>named-pipe</code>.</td></tr><tr><td><code>--tcp-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>Puerto TCP de la sesión. Solo con <code>tcp</code>.</td></tr><tr><td><code>--pipe-name &#x3C;name-or-path></code></td><td><code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Canalización con nombre de la sesión. En Windows, un nombre de canalización. En macOS y Linux, un nombre relativo se resuelve bajo <code>/tmp</code> y una ruta absoluta se usa como ruta exacta del socket Unix.</td></tr></tbody></table>

## Códigos de salida

<table><thead><tr><th width="250">CÓDIGO</th><th>SIGNIFICADO</th></tr></thead><tbody><tr><td><code>0</code></td><td>Éxito.</td></tr><tr><td><code>1</code></td><td>El comando ha fallado.</td></tr><tr><td><code>2</code></td><td>Un parámetro no es válido.</td></tr><tr><td><code>3</code></td><td>La API de automatización no está disponible (no se alcanzó ninguna sesión).</td></tr><tr><td><code>4</code></td><td>Comando desconocido.</td></tr></tbody></table>

## Comandos

### Sesión

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>status</code></td><td></td><td></td><td>Devuelve el transporte, el punto de conexión y la información de compilación de la sesión.</td></tr><tr><td><code>version</code></td><td></td><td></td><td>Devuelve el número de compilación de UniGetUI.</td></tr></tbody></table>

### Aplicación

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>app status</code></td><td></td><td></td><td>Devuelve el estado de la sesión: sin interfaz o no, página actual, acciones de interfaz admitidas.</td></tr><tr><td><code>app show</code></td><td></td><td></td><td>Muestra la ventana de UniGetUI y le da el foco.</td></tr><tr><td><code>app navigate</code></td><td><code>--page &#x3C;page></code></td><td><code>--manager &#x3C;id></code>, <code>--help-attachment &#x3C;path></code></td><td>Abre una página: <code>discover</code>, <code>updates</code>, <code>installed</code>, <code>bundles</code>, <code>settings</code>, <code>managers</code>, <code>own-log</code>, <code>manager-log</code>, <code>operation-history</code>, <code>help</code>, <code>release-notes</code>, <code>about</code>.</td></tr><tr><td><code>app quit</code></td><td></td><td></td><td>Cierra la sesión de forma ordenada, incluida una sin interfaz.</td></tr></tbody></table>

### Operaciones

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>operation list</code></td><td></td><td></td><td>Enumera las operaciones en ejecución, en cola y finalizadas.</td></tr><tr><td><code>operation get</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Devuelve todo sobre una operación.</td></tr><tr><td><code>operation output</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--tail &#x3C;n></code></td><td>Devuelve las líneas de salida de una operación.</td></tr><tr><td><code>operation wait</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--timeout &#x3C;seconds></code>, <code>--delay &#x3C;seconds></code></td><td>Espera hasta que finalice la operación.</td></tr><tr><td><code>operation cancel</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Cancela una operación en cola o en ejecución.</td></tr><tr><td><code>operation retry</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--mode &#x3C;mode></code></td><td>Vuelve a ejecutar la operación. Los modos disponibles se enumeran en la información de la operación.</td></tr><tr><td><code>operation reorder</code></td><td><code>--id &#x3C;operation-id></code>, <code>--action &#x3C;run-now|run-next|run-last></code></td><td></td><td>Mueve una operación en cola dentro de la cola.</td></tr><tr><td><code>operation forget</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Quita una operación finalizada de la lista.</td></tr></tbody></table>

### Gestores de paquetes

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>manager list</code></td><td></td><td></td><td>Enumera los gestores de paquetes y sus capacidades.</td></tr><tr><td><code>manager maintenance</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Devuelve la información de mantenimiento de un gestor.</td></tr><tr><td><code>manager reload</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Vuelve a cargar un gestor.</td></tr><tr><td><code>manager set-executable</code></td><td><code>--manager &#x3C;id></code>, <code>--path &#x3C;path></code></td><td></td><td>Usa un ejecutable personalizado y luego vuelve a cargar el gestor.</td></tr><tr><td><code>manager clear-executable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Quita el ejecutable personalizado y luego vuelve a cargar el gestor.</td></tr><tr><td><code>manager action</code></td><td><code>--manager &#x3C;id></code>, <code>--action &#x3C;action></code></td><td><code>--confirm</code></td><td>Ejecuta una acción de mantenimiento específica del gestor.</td></tr><tr><td><code>manager enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Habilita el gestor.</td></tr><tr><td><code>manager disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Deshabilita el gestor.</td></tr><tr><td><code>manager notifications enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Activa las notificaciones de actualización para el gestor.</td></tr><tr><td><code>manager notifications disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Desactiva las notificaciones de actualización para el gestor.</td></tr></tbody></table>

### Fuentes

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>source list</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Enumera los orígenes, opcionalmente para un gestor.</td></tr><tr><td><code>source add</code></td><td><code>--manager &#x3C;id></code>, <code>--name &#x3C;source-name></code></td><td><code>--url &#x3C;source-url></code></td><td>Agrega un origen.</td></tr><tr><td><code>source remove</code></td><td><code>--manager &#x3C;id></code>, <code>--name &#x3C;source-name></code></td><td><code>--url &#x3C;source-url></code></td><td>Quita un origen.</td></tr></tbody></table>

### Configuración

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>settings list</code></td><td></td><td></td><td>Enumera la configuración normal y sus claves.</td></tr><tr><td><code>settings get</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Lee un ajuste normal.</td></tr><tr><td><code>settings set</code></td><td><code>--key &#x3C;key></code></td><td><code>--enabled true|false</code>, <code>--value &#x3C;text></code></td><td>Establece un ajuste, como booleano o como texto.</td></tr><tr><td><code>settings clear</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Borra un ajuste de texto.</td></tr><tr><td><code>settings reset</code></td><td></td><td></td><td>Restablece la configuración normal.</td></tr><tr><td><code>settings secure list</code></td><td></td><td><code>--user &#x3C;name></code></td><td>Enumera la configuración segura (protegida por el administrador) del usuario actual o indicado.</td></tr><tr><td><code>settings secure get</code></td><td><code>--key &#x3C;key></code></td><td><code>--user &#x3C;name></code></td><td>Lee un ajuste seguro.</td></tr><tr><td><code>settings secure set</code></td><td><code>--key &#x3C;key></code>, <code>--enabled true|false</code></td><td><code>--user &#x3C;name></code></td><td>Activa o desactiva un ajuste seguro.</td></tr></tbody></table>

{% hint style="info" %}
Ejecute `unigetui settings list` y `unigetui settings secure list` para ver las claves disponibles. Lo que hace cada ajuste se describe en [Toda la configuración](/unigetui/es/referencia/settings.md).
{% endhint %}

### Accesos directos del escritorio

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>shortcut list</code></td><td></td><td></td><td>Enumera los accesos directos del escritorio de los que se hace seguimiento y si cada uno se conserva o se elimina.</td></tr><tr><td><code>shortcut set</code></td><td><code>--path &#x3C;path></code>, <code>--status &#x3C;keep|delete></code></td><td></td><td>Marca un acceso directo para conservarlo o eliminarlo.</td></tr><tr><td><code>shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Borra la elección almacenada para un acceso directo.</td></tr><tr><td><code>shortcut reset-all</code></td><td></td><td></td><td>Borra las elecciones almacenadas para todos los accesos directos.</td></tr></tbody></table>

### Accesos directos del menú Inicio

Solo para Windows. La elección se almacena según la ruta del acceso directo y se vuelve a aplicar cada vez que una actualización vuelve a crear el acceso directo. Las rutas fuera de una carpeta `Programs` del menú Inicio, y los archivos que no son accesos directos `.lnk` o `.url`, se rechazan.

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>start-menu shortcut list</code></td><td></td><td></td><td>Enumera los accesos directos del menú Inicio de los que se hace seguimiento y si cada uno se conserva o se elimina.</td></tr><tr><td><code>start-menu shortcut set</code></td><td><code>--path &#x3C;path></code>, <code>--status &#x3C;keep|delete></code></td><td></td><td>Marca un acceso directo del menú Inicio para conservarlo o eliminarlo.</td></tr><tr><td><code>start-menu shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Borra la elección almacenada para un acceso directo.</td></tr><tr><td><code>start-menu shortcut reset-all</code></td><td></td><td></td><td>Borra todas las elecciones almacenadas. Las reglas de carpeta y los accesos directos que movieron no se ven afectados.</td></tr></tbody></table>

### Carpetas del menú Inicio

Solo para Windows. Una regla de carpeta establece la subcarpeta de la carpeta `Programs` del menú Inicio del usuario actual en la que un paquete guarda sus accesos directos. UniGetUI la aplica después de cada instalación y actualización, y elimina los accesos directos movidos cuando se desinstala el paquete.

* `--package` usa el formato `manager\PackageId`, por ejemplo `winget\Python.Python.3.13`. La parte del gestor va en minúsculas. La regla ignora el origen, así que dos paquetes con el mismo gestor y el mismo identificador, de orígenes distintos, comparten una sola regla.
* `--folder` debe ser una subcarpeta de la carpeta `Programs` del menú Inicio. Las rutas absolutas, los segmentos `..` y la carpeta del menú Inicio de todos los usuarios se rechazan.

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>start-menu folder list</code></td><td></td><td></td><td>Enumera las reglas de carpeta. Los paquetes que solo tienen accesos directos pendientes también se enumeran, con una carpeta vacía.</td></tr><tr><td><code>start-menu folder set</code></td><td><code>--package &#x3C;manager\id></code>, <code>--folder &#x3C;name></code></td><td><code>--relocate-existing</code></td><td>Crea una regla de carpeta. <code>--relocate-existing</code> también mueve los accesos directos existentes del paquete.</td></tr><tr><td><code>start-menu folder remove</code></td><td><code>--package &#x3C;manager\id></code></td><td></td><td>Quita la regla de carpeta de un paquete.</td></tr></tbody></table>

### Registros

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>log app</code></td><td></td><td><code>--level &#x3C;n></code></td><td>Devuelve el registro de la aplicación de UniGetUI.</td></tr><tr><td><code>log operations</code></td><td></td><td></td><td>Devuelve el historial de operaciones.</td></tr><tr><td><code>log manager</code></td><td></td><td><code>--manager &#x3C;id></code>, <code>--verbose</code></td><td>Devuelve los registros del gestor de paquetes.</td></tr></tbody></table>

### Copias de seguridad

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>backup status</code></td><td></td><td></td><td>Devuelve la configuración de la copia de seguridad y el estado de inicio de sesión en GitHub.</td></tr><tr><td><code>backup local create</code></td><td></td><td></td><td>Crea una copia de seguridad local.</td></tr><tr><td><code>backup github login start</code></td><td></td><td><code>--launch-browser</code></td><td>Inicia el inicio de sesión en GitHub (flujo de dispositivo).</td></tr><tr><td><code>backup github login complete</code></td><td></td><td></td><td>Completa el inicio de sesión pendiente en GitHub.</td></tr><tr><td><code>backup github logout</code></td><td></td><td></td><td>Cierra la sesión de GitHub y quita el token almacenado.</td></tr><tr><td><code>backup cloud list</code></td><td></td><td></td><td>Enumera las copias de seguridad en la nube.</td></tr><tr><td><code>backup cloud create</code></td><td></td><td></td><td>Carga una copia de seguridad en la nube.</td></tr><tr><td><code>backup cloud download</code></td><td><code>--key &#x3C;name></code></td><td></td><td>Descarga una copia de seguridad en la nube como contenido de lote.</td></tr><tr><td><code>backup cloud restore</code></td><td><code>--key &#x3C;name></code></td><td><code>--append</code></td><td>Importa una copia de seguridad en la nube en el lote actual.</td></tr></tbody></table>

### Lotes

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>bundle get</code></td><td></td><td></td><td>Devuelve el lote actual.</td></tr><tr><td><code>bundle reset</code></td><td></td><td></td><td>Vacía el lote actual.</td></tr><tr><td><code>bundle import</code></td><td></td><td><code>--path &#x3C;path></code>, <code>--content &#x3C;text></code>, <code>--format &#x3C;ubundle|json|yaml|xml></code>, <code>--append</code></td><td>Importa un lote desde un archivo o desde contenido sin procesar.</td></tr><tr><td><code>bundle export</code></td><td></td><td><code>--path &#x3C;path></code></td><td>Exporta el lote actual, opcionalmente a un archivo.</td></tr><tr><td><code>bundle add</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--selection &#x3C;search|installed|updates|auto></code></td><td>Encuentra un paquete y lo añade al lote.</td></tr><tr><td><code>bundle remove</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--selection &#x3C;mode></code></td><td>Quita los paquetes coincidentes del lote.</td></tr><tr><td><code>bundle install</code></td><td></td><td><code>--include-installed true|false</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--skip-hash true|false</code></td><td>Instala los paquetes del lote.</td></tr></tbody></table>

### Paquetes

<table><thead><tr><th width="250">COMANDO</th><th>OBLIGATORIO</th><th>OPCIONAL</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>package search</code></td><td><code>--query &#x3C;text></code></td><td><code>--manager &#x3C;id></code>, <code>--max-results &#x3C;n></code></td><td>Busca paquetes.</td></tr><tr><td><code>package details</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code></td><td>Devuelve los detalles de un paquete.</td></tr><tr><td><code>package versions</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code></td><td>Devuelve las versiones instalables, cuando el gestor lo admite.</td></tr><tr><td><code>package installed</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Enumera los paquetes instalados.</td></tr><tr><td><code>package updates</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Enumera las actualizaciones disponibles.</td></tr><tr><td><code>package install</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--skip-hash true|false</code>, <code>--architecture &#x3C;value></code>, <code>--location &#x3C;path></code>, <code>--wait true|false</code>, <code>--detach</code></td><td>Instala un paquete. El modo asincrónico devuelve de inmediato un identificador de operación.</td></tr><tr><td><code>package download</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--wait true|false</code>, <code>--detach</code>, <code>--output &#x3C;path></code></td><td>Descarga el instalador de un paquete.</td></tr><tr><td><code>package reinstall</code></td><td><code>--id &#x3C;package-id></code></td><td>Igual que <code>package install</code></td><td>Vuelve a instalar un paquete ya instalado.</td></tr><tr><td><code>package repair</code></td><td><code>--id &#x3C;package-id></code></td><td>Igual que <code>package install</code>, más <code>--remove-data true|false</code></td><td>Desinstala y luego vuelve a instalar el paquete.</td></tr><tr><td><code>package update</code></td><td><code>--id &#x3C;package-id></code></td><td>Igual que <code>package install</code></td><td>Actualiza un paquete.</td></tr><tr><td><code>package uninstall</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--scope &#x3C;scope></code>, <code>--remove-data true|false</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--wait true|false</code>, <code>--detach</code></td><td>Desinstala un paquete.</td></tr><tr><td><code>package show</code></td><td><code>--id &#x3C;package-id></code>, <code>--source &#x3C;source></code></td><td></td><td>Abre los detalles del paquete en la ventana de UniGetUI.</td></tr><tr><td><code>package ignored list</code></td><td></td><td></td><td>Enumera las actualizaciones ignoradas.</td></tr><tr><td><code>package ignored add</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--version &#x3C;version></code>, <code>--source &#x3C;source></code></td><td>Ignora las actualizaciones de un paquete.</td></tr><tr><td><code>package ignored remove</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--version &#x3C;version></code>, <code>--source &#x3C;source></code></td><td>Deja de ignorar las actualizaciones de un paquete.</td></tr><tr><td><code>package update-all</code></td><td></td><td></td><td>Pone en cola las actualizaciones de cada paquete que se puede actualizar.</td></tr><tr><td><code>package update-manager</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Pone en cola las actualizaciones de cada paquete de un gestor.</td></tr></tbody></table>

## Sesiones sin interfaz

Inicie UniGetUI con `--headless` para ejecutar la API de automatización sin una ventana, por ejemplo en un agente de compilación o en un script.

```powershell
UniGetUI.exe --headless
```

<table><thead><tr><th width="250">PARÁMETRO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--ipc-api-transport {named-pipe|tcp}</code></td><td>Transporte de la API. Predeterminado: <code>named-pipe</code>.</td></tr><tr><td><code>--ipc-api-port &#x3C;port></code></td><td>Puerto TCP, con el transporte <code>tcp</code>.</td></tr><tr><td><code>--ipc-api-pipe-name &#x3C;name-or-path></code></td><td>Nombre de la canalización, o ruta del socket Unix en macOS y Linux.</td></tr></tbody></table>

Algunos comandos dependen de la ventana y se comportan de otra forma sin interfaz:

<table><thead><tr><th width="250">COMANDO</th><th>EN UNA SESIÓN SIN INTERFAZ</th></tr></thead><tbody><tr><td><code>status</code>, <code>app status</code>, <code>app quit</code></td><td>Totalmente admitido.</td></tr><tr><td><code>app show</code>, <code>app navigate</code></td><td>Error: no hay ninguna ventana.</td></tr><tr><td><code>package show</code></td><td>Abre un flujo de interfaz, así que puede fallar o no hacer nada.</td></tr><tr><td><code>package update-all</code>, <code>package update-manager</code></td><td>Pueden fallar: dependen de la ventana para iniciar las actualizaciones.</td></tr></tbody></table>

## Parámetros de inicio

El ejecutable de UniGetUI también acepta estos parámetros.

<table><thead><tr><th width="250">PARÁMETRO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--daemon</code></td><td>Inicia UniGetUI minimizado en el área de notificación.</td></tr><tr><td><code>--updateapps</code></td><td>Fuerza la instalación de las actualizaciones disponibles. Se conserva por compatibilidad.</td></tr><tr><td><code>--help</code>, <code>-h</code></td><td>Muestra la ayuda de la CLI.</td></tr><tr><td><code>--import-settings &#x3C;file></code></td><td>Importa la configuración desde un archivo JSON. La configuración existente se reemplaza.</td></tr><tr><td><code>--export-settings &#x3C;file></code></td><td>Exporta la configuración a un archivo JSON, creándolo o sobrescribiéndolo.</td></tr><tr><td><code>--enable-setting &#x3C;key></code>, <code>--disable-setting &#x3C;key></code></td><td>Activa o desactiva un ajuste booleano.</td></tr><tr><td><code>--set-setting-value &#x3C;key> &#x3C;value></code></td><td>Establece un ajuste de texto.</td></tr><tr><td><code>--enable-secure-setting &#x3C;key></code>, <code>--disable-secure-setting &#x3C;key></code></td><td>Activa o desactiva un ajuste seguro para el usuario actual. Puede necesitar derechos de administrador.</td></tr><tr><td><code>--enable-secure-setting-for-user &#x3C;user> &#x3C;key></code>, <code>--disable-secure-setting-for-user &#x3C;user> &#x3C;key></code></td><td>Activa o desactiva un ajuste seguro para el usuario indicado. Puede necesitar derechos de administrador.</td></tr><tr><td><code>--no-corrupt-dialog</code></td><td>Muestra el informe de bloqueo detallado en lugar del cuadro de diálogo simplificado.</td></tr><tr><td><code>--delete-shortcuts &#x3C;path> [&#x3C;path>...]</code></td><td>Elimina accesos directos del escritorio o del menú Inicio y luego se cierra. Se usa internamente para quitar accesos directos que el usuario actual no puede eliminar. Solo se aceptan los archivos <code>.lnk</code> y <code>.url</code> de una carpeta del escritorio o del menú Inicio.</td></tr><tr><td><code>--migrate-wingetui-to-unigetui</code></td><td>Migra los datos y los accesos directos de una instalación heredada de WingetUI y luego se cierra.</td></tr><tr><td><code>--uninstall-wingetui</code></td><td>Quita el WingetUI heredado del panel de notificaciones y se cierra. Lo usa el desinstalador de WingetUI.</td></tr><tr><td><code>&#x3C;bundle-file></code></td><td>Abre un lote en <em><strong>Lotes de paquetes</strong></em>. Las extensiones admitidas incluyen <code>.ubundle</code>, <code>.json</code>, <code>.yaml</code> y <code>.xml</code>.</td></tr></tbody></table>

## Variables de entorno

UniGetUI las lee al iniciarse.

<table><thead><tr><th width="250">VARIABLE</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>UNIGETUI_WINGET_CLI</code></td><td>Herramienta que usa el gestor WinGet: <code>default</code>, <code>winget</code> o <code>pinget</code>. Reemplaza el ajuste <em><strong>Herramienta de línea de comandos de WinGet</strong></em>.</td></tr><tr><td><code>UNIGETUI_WINGET_COM</code></td><td>Uso de la API COM de WinGet: <code>default</code>, <code>enabled</code> o <code>disabled</code> (<code>on</code>/<code>off</code>, <code>true</code>/<code>false</code> y <code>1</code>/<code>0</code> también funcionan). Reemplaza el ajuste <em><strong>API COM de WinGet</strong></em>.</td></tr><tr><td><code>UNIGETUI_FONT_FAMILY</code></td><td>Solo para Windows. Familia de fuentes añadida al principio de la lista de fuentes de la interfaz. Se ignora cuando UniGetUI usa la fuente del sistema de Windows.</td></tr><tr><td><code>UNIGETUI_FORCE_NATIVE_LINUX_DECORATIONS</code></td><td>Solo para Linux. Fuerza la barra de título del gestor de ventanas activada (<code>1</code>, <code>true</code>, <code>on</code>, <code>yes</code>, <code>enabled</code>) o desactivada (<code>0</code>, <code>false</code>, <code>off</code>, <code>no</code>, <code>disabled</code>), en lugar de detectarla.</td></tr><tr><td><code>UNIGETUI_GITHUB_TOKEN_NAMESPACE</code></td><td>Sufijo añadido a la entrada de credenciales del token de copia de seguridad de GitHub, para que varias instancias de UniGetUI en un mismo ordenador puedan usar cuentas de GitHub distintas.</td></tr><tr><td><code>WEBVIEW2_BROWSER_EXECUTABLE_FOLDER</code></td><td>Solo para Windows. Carpeta de un runtime de WebView2 de versión fija, para usarla en lugar del instalado.</td></tr><tr><td><code>UNIGETUI_IPC_API_TRANSPORT</code>, <code>UNIGETUI_IPC_API_PORT</code>, <code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Consulte <a href="#connection-options">Opciones de conexión</a>.</td></tr></tbody></table>

## Vínculos profundos

En Windows, una instalación normal registra el protocolo `unigetui://`. Las instalaciones portátiles no.

<table><thead><tr><th width="250">VÍNCULO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>unigetui://openUniGetUI</code></td><td>Muestra la ventana de UniGetUI.</td></tr><tr><td><code>unigetui://openUniGetUIOnUpdatesTab</code></td><td>Muestra UniGetUI en <em><strong>Actualizaciones de software</strong></em>.</td></tr><tr><td><code>unigetui://updateAll</code></td><td>Actualiza cada paquete que tiene una actualización.</td></tr><tr><td><code>unigetui://releaseSelfUpdateLock</code></td><td>Permite que continúe una actualización pendiente de UniGetUI.</td></tr></tbody></table>

{% hint style="warning" %}
Un vínculo profundo solo actúa cuando UniGetUI ya se está ejecutando. Si el vínculo inicia UniGetUI, la aplicación se abre con normalidad y la acción se ignora. Para automatizar UniGetUI, use los comandos anteriores o la [API de automatización](/unigetui/es/referencia/ipc-api.md).
{% endhint %}

## Modificadores del instalador

Los modificadores del instalador de Windows (instalación silenciosa, todos los usuarios, portátil, omisión de dependencias) se enumeran en [Instalar UniGetUI](/unigetui/es/referencia/installation.md#installer-switches).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/es/referencia/cli.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.