Acerca de la CLI de UiPath

Nota:

UiPath CLI está actualmente en vista previa pública. Todas las versiones anteriores a la versión 1.0.0 son versiones de vista previa y pueden incluir cambios de última hora entre versiones. La versión 1.0.0 marcará la primera versión estable.

La interfaz de línea de comandos de UiPath (UiPath CLI, invocada uip) es la herramienta de línea de comandos multiplataforma para UiPath Platform. Permite a los desarrolladores, ingenieros de RPA y equipos de DevOps crear, gestionar, operar e implementar automatizaciones de UiPath (trabajos y recursos de Orchestrator, soluciones, agentes, flujos, procesos de Maestro, activos de Test Manager y más) desde un terminal o un CI/CD canalización.

UiPath CLI se distribuye en npm y sigue el control de versiones semántico (MAJOR.MINOR.PATCH). Esto reemplaza el esquema basado en calendario utilizado hasta 2025.10 y el .NET CLI heredado (uipcli.exe).

Nota:

Esta es la documentación de UiPath CLI (el comando basado en uip ). Para.NET CLI heredado (uipcli.exe / dotnet uipcli.dll), consulta la documentación de integraciones CI/CD 2025.10. Hay disponible una guía de migración .

Para la extensión de Azure DevOps, el complemento de Jenkins y otras integraciones de procesos, consulta Integraciones CI/CD.

Más que una herramienta de CI/CD

Las herramientas de línea de comandos de UiPath anteriores se centraban en las tareas de CI/CD: empaquetar, analizar, implementar y ejecutar pruebas. UiPath CLI 1.x mantiene todo eso y añade la superficie de plataforma completa. Puedes utilizar uip para:

• Crear : proyectos de andamio (uip solution new, uip agent init, uip flow init, uip maestro init), paquete (uip rpa pack, uip solution pack, uip agent pack) y análisis (uip rpa analyze con políticas de control).
• Administrar : trabaja con carpetas, usuarios, roles y licencias de Orchestrator; crear y actualizar activos, colas, depósitos de almacenamiento, bibliotecas, desencadenadores y webhooks; administrar proyectos, conjuntos de pruebas y resultados de Test Manager; gestionar los conectores y conexiones de Integration Service.
• Operar : iniciar, detener e inspeccionar trabajos de Orchestrator; supervisar las instancias e incidentes de Flow y Maestro; ejecutar agentes y evaluarlos en conjuntos de datos; ejecutar conjuntos de pruebas y leer resultados.
• Implementar : cargar paquetes, crear y actualizar procesos, publicar soluciones y agentes, activar o desinstalar implementaciones de soluciones.

Esta es la misma herramienta tanto si eres un desarrollador que explora la plataforma desde un portátil como un proceso que realiza implementaciones unattended. Los verbos, marcas, formatos de salida y códigos de salida son los mismos en ambos contextos.

Diseñado para humanos y agentes de codificación

UiPath CLI está diseñado para ser consumido igualmente bien por dos audiencias:

• Humanos : una experiencia de terminal primero con uip login interactivo, finalización de pestaña de shell (uip completion), vista --output table en color y ayuda incrustada en cada comando (uip <cmd> --help).
• Agentes de codificación : el sistema uip skills instala habilidades de UiPath en agentes de codificación para que sepan cómo crear, implementar y operar automatizaciones de UiPath con uip , no solo qué comandos existen. Agentes compatibles: Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex y OpenCode.

uip skills install el catálogo completo de habilidades de UiPath de GitHub y lo instala en uno o más agentes de codificación. Eliges los agentes de destino (no las habilidades individuales: el propio agente decide qué habilidad se aplica a una tarea determinada) pasando --agent <name> o de forma interactiva desde una solicitud de casilla de verificación cuando se omite el marcador. Por defecto, la instalación es global; añade --local a las habilidades de ámbito del proyecto actual (donde el agente lo admita; Claude Code es solo global, por ejemplo).

uip skills install                         # prompts you to pick one or more agents
uip skills install --agent claude          # non-interactive, skills installed globally for Claude Code
uip skills install --agent cursor --local  # non-interactive, skills installed into the current project for Cursor
uip skills update --agent claude           # re-fetch and reinstall to pick up new skills
uip skills uninstall --agent claude        # remove skills for Claude Code

Los mismos comandos funcionan de cualquier manera. Una invocación uip que un desarrollador escribe a mano es exactamente la misma llamada que hace un agente, lo que significa que tu equipo puede crear una automatización de forma interactiva, canalizar la secuencia exacta en un script y entregarla a un agente de IA para iterar más.

La salida es JSON de forma predeterminada : lo mismo en un portátil de desarrollador y en un proceso, por lo que los scripts no necesitan ramificarse si se ejecutan de forma interactiva. Añade --output table para la vista de lectura fácil, --output yaml para YAML o --output plain para key=value líneas. El filtrado JMESPath está disponible a través de --output-filter "Data[*].Name".

Cómo está organizada la UiPath CLI

uip es un pequeño host con un sistema de complementos. El host gestiona la autenticación, la gestión de sesiones, la configuración y el ciclo de vida de la herramienta. Todo lo demás (Orchestrator, Solución, Agente, Flujo, Maestro, RPA, Test Manager, etc.) se envía como una herramienta instalable en npm.

uip <tool> <resource-or-command> [subcommand] [options]

Ejemplos:

uip login                                # core command
uip or jobs list                         # orchestrator jobs (manage + operate)
uip solution pack ./MySolution ./dist    # solution packing (build)
uip rpa analyze ./MyProject              # workflow analyzer (build)
uip agent deploy my-agent                # agent deploy (deploy)

Un npm install -g @uipath/cli nuevo solo contiene los comandos del host y del núcleo; no hay herramientas preinstaladas. La primera vez que invocas un comando cuyo prefijo coincide con una herramienta en la lista blanca, el host instala esa herramienta desde npm automáticamente. También puedes instalar herramientas explícitamente con uip tools install <name> : útil para la preparación sin conexión y los ejecutores de CI. Consulta Herramientas (complementos) para obtener más detalles.

Herramientas incorporadas

Todas las herramientas a continuación están en la lista blanca de instalación automática: basta con escribir el prefijo. Los prefijos que se muestran son los nombres canónicos tal como se definen en el host:

Herramienta	Prefijo	Propósito
Orchestrator	or	Trabajos, carpetas, procesos, paquetes, máquinas, usuarios, roles, licencias, fuentes
Solución	solution	Andamiar, empaquetar, publicar, cargar, implementar soluciones de UiPath
Recurso	resource	Activos, colas, depósitos de almacenamiento, bibliotecas, desencadenadores, webhooks
RPA	rpa	Empaquetado de proyectos de Studio, analizador de flujo de trabajo, restauración de dependencias
Agente	agent	Creación, empaquetado, implementación y ejecución de agentes de código bajo
Agente codificado	codedagent	Agentes codificados basados en Python
Aplicación codificada	codedapp	Proyectos de aplicaciones web codificadas
Maestro	maestro	Creación de proyectos de Maestro, empaquetado, operaciones de runtime
Test Manager	tm	Casos de prueba, conjuntos de pruebas, ejecuciones, resultados, informes
Integration Service	is	Conectores y conexiones
Soluciones verticales	vss	Andamiaje y generación de soluciones verticales
Flujo de trabajo de API	api-workflow	Ejecución local de flujos de trabajo de la API de UiPath
Data Fabric	df	Operaciones de Data Fabric
Insights	insights	Paneles e informes de Insights
Seguimientos	traces	Seguimientos de ejecución y diagnósticos
IA de Documentos	docsai	Búsqueda de documentación de UiPath impulsada por IA

Consejo:

Ejecuta uip --help para ver los prefijos exactos en tu instalación y uip tools list para ver qué herramientas están instaladas actualmente. Solo las herramientas @uipath/ en la lista blanca anteriores son compatibles con UiPath CLI 1.x; la extensión de terceros aún no está disponible. La herramienta Flow (@uipath/flow-tool) está publicada, pero no en la lista blanca de instalación automática: instálala explícitamente con uip tools install @uipath/flow-tool antes de usar los comandos uip flow .

Autenticación de un vistazo

UiPath CLI admite tres flujos de autenticación. El flujo interactivo es nuevo en 1.x; los otros dos tienen análogos en el .NET CLI heredado.

Flujo	Cuando usarlo	Cómo usarla
Inicio de sesión de usuario interactivo de OAuth2 (nuevo en 1.x)	Desarrolladores que trabajan desde un terminal. Vincula la sesión a tu cuenta personal y sus permisos.	uip login abre un navegador para iniciar sesión y selecciona un tenant. Los tokens de sesión se almacenan y actualizan automáticamente.
Aplicación externa (credenciales de cliente)	Procesos de CI/CD, servidores, cualquier contexto no interactivo. Vincula la sesión a una aplicación externa que creas en UiPath, con ámbitos explícitos.	uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant <name> — el prefijo env.VAR lee el secreto de una variable de entorno sin exponerlo en la línea de comandos.
Autenticación de variables de entorno	Contenedores y ejecutores efímeros que ya tienen un token de acceso a UiPath. Sin navegador, sin aplicación externa de ida y vuelta, sin estado en disco.	Establezca UIPATH_CLI_ENABLE_ENV_AUTH=true y proporcione UIPATH_CLI_AUTH_TOKEN + variables de organización/tenant. Cada comando uip se autentica desde las variables de entorno; no hay actualización.

Consulta Autenticación para obtener el flujo completo, la selección de tenants, el diseño de carpetas de credenciales y cómo preconfigurar Apps externas para CI.

UiPath CLI frente a .NET CLI heredado

Aspecto	UiPath CLI (uip, 1.x)	.NET CLI heredado (uipcli, 2025.10 y anteriores)
Tiempo de ejecución	Node.js (multiplataforma)	.NET 8 (Windows primero)
Distribución	npm install -g @uipath/cli	.nupkg en la fuente MyGet/NuGet
Control de versiones	Versiones semánticas (1.0.0, 1.1.0, …)	Versiones de calendario (2023.10, 2024.10, 2025.10)
Ámbito	Cree, gestione, opere e implemente en toda la plataforma	Centrado en CI/CD: empaquetar, analizar, implementar y ejecutar pruebas
Autenticación	OAuth2 interactivo (uip login) y aplicación externa (credenciales de cliente)	Aplicación externa (credenciales de cliente), más autenticación básica/token obsoleta
Arquitectura	Herramientas modulares, autoinstaladas en el primer uso desde npm	Ejecutable monolítico
Formatos de salida	table, json, yaml, plain con filtrado JMESPath	Texto/JSON (limitado)
Integración de IA	Sistema de habilidades para agentes de codificación	No disponible
Analizador de flujo de trabajo	Conservado como uip rpa analyze, con soporte de política de archivos de control	Incluido con CLI (uipcli package analyze)
Restauración de dependencias	Conservado como uip rpa restore, con soporte aislado y NuGet-config	Incluido con CLI (uipcli package restore)

Si está iniciando un nuevo proceso hoy, utilice UiPath CLI 1.x. Si mantienes los procesos existentes de Azure DevOps o Jenkins creados en uipcli.exe, consulta la guía de migración para el mapa de comandos, los cambios de nombre de las marcas y los cambios de última hora.

UiPath CLI frente a los complementos de CI/CD

UiPath CLI (uip) es la herramienta. La extensión de Azure DevOps, el complemento de Jenkins e integraciones de procesos similares son envoltorios de esa herramienta: empaquetan invocaciones uip detrás de formularios de tareas impulsados por la interfaz de usuario, inyección de variables seguras y registro nativo del proceso. En el futuro, las versiones más recientes de esos complementos llamarán a uip internamente.

Utiliza el complemento cuando quieras la IU del proceso y la gestión de variables. Usa uip directamente (a través de un paso bash o pwsh ) cuando quieras las últimas capacidades de CLI sin esperar el lanzamiento de un complemento, o cuando necesites un comando que el complemento no expone.

Consulta Integraciones CI/CD para obtener la documentación del complemento.

Plataformas admitidas

UiPath CLI 1.x se ejecuta en cualquier plataforma que admita Node.js 18 o posterior:

• Windows (x64, ARM64)
• macOS (x64, ARM64)
• Linux (x64, ARM64)

Estabilidad y cadencia de lanzamiento

UiPath CLI sigue el versionado semántico:

• MAYOR : romper los cambios en los nombres de los comandos, la semántica de los marcadores o el sobre JSON. Un ciclo de obsolescencia precede a cualquier versión MAYOR.
• MENOR : nuevos comandos, nuevos marcadores, nuevas herramientas; solo aditivo. Ten en cuenta que la forma de Data en la salida JSON es específica del comando y puede cambiar en las versiones MENOR; los procesos deben anclar @uipath/cli.
• PARCHE : correcciones de errores; ningún cambio de comportamiento documentado.

Los comandos y herramientas individuales están etiquetados como GA, Vista previa o Obsoletos. Los comandos de vista previa pueden cambiar sin un cambio de versión principal; los comandos obsoletos siguen funcionando durante al menos un ciclo MAYOR. Consulta Control de versiones y estabilidad para ver el contrato completo.

Próximos pasos

• Instala UiPath CLI : configura uip en Windows, macOS o Linux.
• Inicio rápido : inicia sesión, enumera las carpetas de Orchestrator y ejecuta un trabajo en cinco minutos.
• Tu primer proceso : empaqueta un proyecto e impleméntalo desde un proceso de CI.
• Uso de UiPath CLI con agentes de codificación : instala habilidades en Claude Code, Cursor, GitHub Copilot o Gemini CLI y permíteles crear automatizaciones de UiPath con uip.
• Referencia de comando : referencia completa para cada comando.
• Migrar desde .NET CLI heredado : si vienes de uipcli.exe.