Acerca de la CLI de UiPath

Arquitectura y capacidades de UiPath CLI, la interfaz de línea de comandos multiplataforma para crear y operar automatizaciones de UiPath.

Nota:

UiPath CLI alcanzó la disponibilidad general en la versión 1.197.0 (31 de julio de 2026). Todas las versiones anteriores a la 1.197.0 eran versiones de vista previa y podían incluir cambios de última hora entre versiones.

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 init, uip agent init, uip maestro flow init, uip maestro bpmn 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, Codex, OpenCode, UiPath Autopilot, Kiro (Amazon Q), Windsurf, Antigravity CLI y Devin.

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

Las siguientes herramientas son las superficies básicas de automatización de la plataforma, cada una 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. Este es un subconjunto representativo, no la lista completa: UiPath CLI incluye más de 30 herramientas en la lista blanca en total, que abarcan todo, desde Orchestrator hasta la gobernanza, la configuración de LLM y Process Mining. Consulta Herramientas (complementos) para ver la tabla completa y exacta (sincronizada con la lista blanca del host) o la página Referencia de comandos para el alias y referencia de cada herramienta.

Herramienta	Prefijo	Propósito
Orchestrator	or	Trabajos, carpetas, procesos, paquetes, máquinas, usuarios, roles, licencias, fuentes, activos, colas, depósitos de almacenamiento, bibliotecas, desencadenadores, webhooks
Solución	solution	Andamiar, empaquetar, publicar, cargar, implementar soluciones de UiPath
RPA	rpa	Empaquetado de proyectos de Studio, analizador de flujo de trabajo, restauración de dependencias
RPA heredado	rpa-legacy	Envoltura solo para Windows de uipcli.exe para los comandos de Studio que aún no se han migrado a la herramienta multiplataforma rpa
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/empaquetado/runtime del proceso BPMN, más las ramas flow y case (consulta la nota a continuación)
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
Evaluación	eval	Evaluación de runtime de paquetes implementados en comparación con un proceso de Orchestrator: un paquete independiente, no un subcomando de or

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/ permitidas mencionadas anteriormente son compatibles con UiPath CLI 1.x; la extensión de terceros aún no está disponible. Maestro Flow y Case no son herramientas incluidas en la lista blanca por separado. @uipath/maestro-tool es el único paquete en la lista blanca para maestro; importa directamente @uipath/flow-tool y @uipath/case-tool como sus propias dependencias para registrar las ramas uip maestro flow y uip maestro case. La instalación de maestro-tool incorpora ambos: no hay un desencadenador de instalación automática independiente para flow o case por sí mismos.

Autenticación de un vistazo

UiPath CLI admite cinco flujos de autenticación. El flujo interactivo es nuevo en 1.x; La aplicación externa y la autenticación de variables de entorno tienen análogos en la CLI de .NET heredada; las credenciales federadas son para configuraciones de identidad de carga de trabajo que no pueden contener un secreto de larga duración; Las credenciales de Robot son para Studio Desktop y otros contextos alojados en Robot.

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.
Credenciales federadas (identidad de carga de trabajo)	Plataformas CI/CD que pueden emitir sus propios tokens OIDC (por ejemplo, una configuración de identidad de carga de trabajo de GitHub Actions o Azure DevOps): sin secreto de cliente de larga duración para almacenar o rotar.	uip login --client-id <app-id> --client-assertion env.OIDC_TOKEN — un OIDC JWT representa el secreto del cliente. Requiere --client-id; mutuamente excluyentes con --client-secret.
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.
Credenciales de robot	Studio Desktop y otros contextos alojados en UiPath Robot, autenticados a través del Robot que ya se está ejecutando en la máquina.	Establece UIPATH_CLI_ENFORCE_ROBOT_AUTH=true. Se autentica exclusivamente a través del canal IPC del robot local; mutuamente excluyentes con la autenticación de variable de entorno.

Los tres primeros flujos persisten una sesión en una carpeta de credenciales. --profile <name> (un marcador global — consulta Opciones globales) nombra una sesión para que varios inicios de sesión puedan coexistir uno al lado del otro, independientemente de qué flujo los haya creado; pasar el mismo --profile en comandos posteriores para reutilizar esa sesión específica.

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 22 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 cualquier otro agente compatible 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.