Novedades

UiPath CLI es una reescritura desde cero de las herramientas de línea de comandos, que reemplaza la herramienta uipcli.exe .NET utilizada a través de 2025.10. Si estás migrando desde un proceso 2025.10, lee la guía de migración : esta página es el resumen principal de lo que cambió y por qué.

Una herramienta diferente

UiPath CLI es una CLI de TypeScript distribuida en npm como @uipath/cli e invocada como uip. Se ejecuta en Node.js 18+ en Windows, macOS y Linux. El host y la mayoría de las herramientas no tienen dependencia de .NET; rpa-tool es la excepción: envuelve el empaquetador de Studio y el compilador de flujo de trabajo, los cuales aún requieren un tiempo de ejecución .NET. Instala el host de la misma manera en todos los entornos:

npm install -g @uipath/cli

El CLI es un host de complementos. Los comandos para cada superficie de UiPath (Orchestrator, Soluciones, Agentes, Flujos, Maestro, Test Manager, etc.) se envían como paquetes npm independientes que se uip instalan automáticamente la primera vez que se utilizan. Consulta Herramientas (complementos).

Versionado semántico

El control de versiones basado en calendario (2023.10, 2024.10, 2025.10) ha desaparecido. 1.0.0 es el punto de partida de un contrato de servidor :

• MAYOR : interrumpir primero los cambios con un ciclo de obsolescencia completo.
• MENOR : nuevos comandos, nuevos marcadores, solo aditivo. Data forma puede evolucionar.
• PARCHE : solo correcciones de errores.

Las versiones de host y herramienta se coordinan: cada herramienta realiza un seguimiento de la línea MAYOR.MENORES de la CLI de forma predeterminada. Consulta Control de versiones y estabilidad.

Más de CI/CD

La CLI heredada era una herramienta CI/CD: empaquetar, analizar, implementar, ejecutar pruebas. UiPath CLI 1.x cubre la plataforma completa (crear, gestionar, operar, implementar) y está diseñado para ser utilizado de forma interactiva por los desarrolladores, así como mediante programación por los procesos. Ahora puedes:

• Andamiar y validar proyectos (uip solution new, uip agent init, uip flow init, uip maestro init).
• Gestiona los recursos de Orchestrator (carpetas, procesos, paquetes, máquinas, usuarios, roles, licencias, colas, activos, depósitos, webhooks).
• Iniciar y supervisar trabajos (uip or jobs start, uip or jobs get), con --wait-for-completion opcional.
• Impulsa el ciclo de vida completo del agente, incluida la evaluación (uip agent eval).
• Inspeccionar instancias e incidentes de Flow y Maestro.
• Gestionar entidades de Data Fabric y conexiones de Integration Service.

Cada comando devuelve el mismo sobre JSON estructurado, por lo que cualquier cosa que puedas hacer a mano es programable.

JSON por defecto

La salida es JSON en la salida estándar de forma predeterminada, con un sobre estable (Result, Code, Data, Message, Instructions). Los humanos optan por la vista de tabla con --output table; los procesos y los agentes de IA obtienen datos limpios y estructurados sin marcadores adicionales. Consulta Formatos de salida.

Inicio de sesión interactivo fácil de usar

uip login un navegador, inicia sesión en UiPath y mantiene la sesión actualizada dentro de ~/.uipath/. Las credenciales de cliente ya no necesitan estar incrustadas en una estación de trabajo de desarrollador. Los procesos de CI siguen utilizando credenciales de cliente de aplicación externa (ahora pasadas a través de --client-id env.UIPATH_CLIENT_ID), y los contenedores pueden utilizar la autenticación de variable de entorno con un token de acceso opaco. Consulta Autenticación.

Creado para agentes de codificación de IA

El sistema uip skills enseña a Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex y OpenCode cómo utilizar uip. UiPath publica las habilidades y las instala por agente. Una vez instalado, el agente puede impulsar un flujo completo de paquete-publicación-implementación sin necesidad de escribir cada comando. Consulta Utilizar UiPath CLI con agentes de codificación.

Finalización del shell

uip completion la finalización de pestañas para bash, zsh, fish y PowerShell. La finalización de valor de marcador dinámico (por ejemplo, uip or packages upload --package-name <TAB>) está disponible en zsh cuando jq está en la RUTA; el subcomando estático y la finalización del nombre de la opción funcionan en los cuatro shells.

Otros turnos significativos

• Sin lectura de autenticación implícita de env-var. UIPATH_CLIENT_ID y UIPATH_CLIENT_SECRET ya no se leen automáticamente. Pásalas a través de --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET (el prefijo env. busca la variable en tiempo de ejecución sin exponerla en la línea de comandos).
• Códigos de salida ajustados a cinco valores (0/1/2/3/4, más 130 para la cancelación del usuario). El contrato es estable dentro de una versión MAYOR: script contra ellos. Consulta Códigos de salida.
• Filtrado JMESPath (--output-filter) en cada comando, en tiempo de análisis, con código de salida 3 en errores de sintaxis para que un error tipográfico no desperdicie una llamada a la API.
• Multiplataforma. Se admiten ARM64 Windows, macOS y Linux, un reflejo del tiempo de ejecución de Node.js.
• Se ha cambiado el nombre de la variable de exclusión de telemetría de UIPATH_EXTENSIONS_CLI_TELEMETRY_ENABLED=False a UIPATH_TELEMETRY_DISABLED=1. Ambas generaciones están desactivadas de forma predeterminada: actualiza los ejecutores de CI que dependían del nombre antiguo.

Por dónde empezar

• ¿Nuevo usuario? Inicio rápido.
• ¿Migrar desde 2025.10? Guía de migración.
• ¿Configurando CI? Tu primer proceso → elige una receta de CI/CD.
• ¿Trabaja con agentes de IA? Uso de UiPath CLI con agentes de codificación.

Consulta Notas de la versión para obtener la lista completa de cambios y cualquier cosa enviada después.