uip (comandos básicos)

La superficie de comandos del núcleo es todo lo que se incluye en el host (@uipath/cli), sin necesidad de instalar ninguna herramienta. Estos comandos gestionan la autenticación, el ciclo de vida de la herramienta, las habilidades del agente de codificación de IA, el puente MCP y la finalización del shell. Todos los comandos de esta página están disponibles en el momento en que finaliza npm install -g @uipath/cli .

Para los comandos que se comunican con una superficie de UiPath (Orchestrator, Soluciones, Agentes, etc.), consulta las páginas de referencia por herramienta: cada una se proporciona mediante un paquete npm independiente que el host carga bajo demanda.

Los siete comandos

Comando	Propósito	Se requiere inicio de sesión
uip login	Autenticarse a través de OAuth2 interactivo o aplicación externa; cambiar de tenant. Escribe una sesión en .uipath/.auth.	—
uip logout	Elimina el archivo de credenciales.	—
uip login status	Muestra la organización actual, el tenant, la caducidad y qué archivo de credenciales está leyendo la CLI.	Opcional (informa Not logged in de lo contrario)
uip tools	Enumera, busca, instala, actualiza y desinstala las herramientas instalables (Orchestrator, Solution, Agent, Flow, …).	—
uip skills	Instale las habilidades de UiPath en los agentes de codificación de IA (Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex, OpenCode).	—
uip mcp	Exponer CLI como servidor de protocolo de contexto de modelo a través de stdio.	Por run_command (hereda la sesión basada en archivo).
uip completion	Instalar o imprimir la finalización de la pestaña del shell (bash, zsh, fish, pwsh).	—

Sinopsis

uip login [--interactive] [--tenant <name>] [--organization <name>] [--client-id <id>] [--client-secret <secret>] [--scope <scopes>] [-f <folder>]
uip login status                       [-f <folder>]
uip login tenant list                  [-f <folder>]
uip login tenant set <name>            [-f <folder>]
uip logout                             [-f <folder>]
uip tools list / search / install / update / uninstall …
uip skills install / update / uninstall --agent <claude|cursor|copilot|gemini|codex|opencode>
uip mcp serve
uip completion [shell] [--print] [--uninstall]

Todos los comandos básicos respetan las cuatro opciones globales (--output, --output-filter, --log-level, --log-file) y siguen el contrato de código de salida estándar.

Cómo se relaciona la superficie del núcleo con las herramientas

Cada invocación uip <tool> … se ejecuta sobre estos:

1. La autenticación se establece una vez con uip login y es heredada por cada llamada de herramienta posterior (Orchestrator, Solución, Agente, …).
2. El ciclo de vida de la herramienta (uip tools install) controla qué paquetes de extensión se cargan la próxima vez que se invoca un prefijo de herramienta.
3. Las habilidades se encuentran junto a las herramientas: enseñan a los agentes de IA a utilizar uip en lugar de añadir nuevos comandos.
4. MCP envuelve toda la superficie (herramientas básicas + instaladas) como una única herramienta MCP a la que cualquier cliente compatible con MCP puede llamar.
5. La finalización descubre los comandos en el momento de la instalación, así que vuelve a ejecutar uip completion después de uip tools install si quieres que se completen los comandos recién añadidos.

Consulta Cómo se organiza UiPath CLI para la arquitectura host-vs-tool en profundidad.

Forma de autenticación

Todos los comandos básicos, excepto los propios comandos de autenticación, funcionan sin una sesión: solo se comunican con los archivos locales (config, manifest, script de finalización). Los comandos de autenticación gestionan la propia sesión:

• uip login flujos: OAuth2 interactivo (navegador), aplicación externa (credenciales de cliente) y token de variable de entorno. Consulta Autenticación.
• uip logout : elimina el archivo. El flujo env-var no tiene nada que borrar.
• uip login status : informa de la sesión activa.
• uip login tenant list / set : cambia de tenant sin volver a autenticar.

Los comandos de herramientas heredan cualquier sesión que esté en el disco en el momento de la invocación; --tenant anula por llamada.

Donde cada comando envía su salida

Transmisión	Contenido
Salida estándar	El sobre JSON estructurado (Result, Code, Data, …). Uno por invocación.
Estándar	Registros (controlados por --log-level), indicadores de progreso y texto de error legible por humanos. JSON nunca analizable por máquina.

La división se aplica en todas partes; puedes redirigirlos de forma independiente:

uip tools list > tools.json 2> uip.log

Consulta Formatos de salida para los cuatro formatos (json, table, yaml, plain) y el filtrado JMESPath.

Ver también

• Conceptos: cómo se organiza UiPath CLI : qué significa "host" y por qué el núcleo se divide de las herramientas.
• Conceptos: herramientas (complementos) : la lista blanca de instalación automática y la fijación de versiones.
• Conceptos: habilidades : cómo uip skills install extiende los agentes de IA.
• Conceptos: sesiones y credenciales : qué escribe uip login y dónde.
• Autenticación : los tres flujos de autenticación en detalle.
• Opciones globales, códigos de salida : contratos compartidos por cada comando.