À propos de la CLI UiPath

Architecture et fonctionnalités de la UiPath CLI, l'interface de ligne de commande multiplateforme pour la création et l'exploitation des automatisations UiPath.

Remarque :

La UiPath CLI a atteint la disponibilité générale à la version 1.197.0 (31 juillet 2026). Toutes les versions antérieures à la version 1.197.0 étaient des versions d'aperçu et pouvaient inclure des changements radicaux entre les versions.

L’interface de ligne de commande UiPath (UiPath CLI, invoquée sous le nom uip) est l’outil de ligne de commande multiplate-forme de la plate-forme UiPath. Il permet aux développeurs, aux ingénieurs RPA et aux équipes DevOps de créer, de gérer, d'exploiter et de déployer des automatisations UiPath — Tâches et ressources Orchestrator, Solutions, Agents, Flux, Processes Maestro, Ressources Test Manager, et plus — à partir d'un terminal ou d'un CI/CD Pipeline.

UiPath CLI est distribuée sur npm et suit le contrôle de version sémantique (MAJOR.MINOR.PATCH). Cela remplace le schéma basé sur un calendrier utilisé jusqu’à 2025.10 et l’ancienne CLI.NET (uipcli.exe).

Remarque :

Il s'agit de la documentation de la UiPath CLI (la commande uip basée sur TypeScript). Pour la CLI.NET héritée (uipcli.exe / dotnet uipcli.dll), consultez la documentation des intégrations CI/CD 2025.10. Un guide de migration est disponible.

Pour l' extension Azure DevOps, le plug-in Jenkins et d'autres intégrations de pipeline, consultez Intégrations CI/CD.

Plus qu’un outil CI/CD

Les outils de ligne de commande UiPath se concentraient sur les tâches CI/CD — compresser, analyser, déployer, exécuter des tests. La version UiPath CLI 1.x d’UiPath conserve tout cela et ajoute la surface complète de la plateforme. Vous pouvez utiliser uip pour:

• Créer : créer des projets d'élaboration (uip solution init, uip agent init, uip maestro flow init, uip maestro bpmn init), compresser (uip rpa pack, uip solution pack, uip agent pack) et analyser (uip rpa analyze avec des politiques de gouvernance).
• Gérer : travailler avec les dossiers, les utilisateurs, les rôles et les licences Orchestrator; créer et mettre à jour des ressources, des files d'attente, des compartiments de stockage, des bibliothèques, des déclencheurs et des webhooks; dicter les projets, les ensembles de tests et les résultats Test Manager; gérer les connecteurs et les connexions Integration Service.
• Opérer : démarrer, arrêter et inspecter les tâches Orchestrator; surveiller les instances et les incidents Flow et Maestro; exécuter des agents et les évaluer par rapport à des ensembles de données; exécuter des ensembles de tests et lire les résultats.
• Déployer : télécharger des packages, créer et mettre à jour des processus, publier des solutions et des agents, activer ou désinstaller les déploiements de solutions.

Il s'agit du même outil que vous soyez un développeur explorant la plate-forme à partir d'un ordinateur portable ou d'un pipeline effectuant des déploiements Unattended. Les verbes, les indicateurs, les formats de sortie et les codes de sortie sont les mêmes dans les deux contextes.

Conçu pour les humains et les agents de codage

L'UiPath CLI est conçue pour être également utilisée par deux publics:

• Human -in---------------- ces---- une expérience de terminal-first avec uip login interactif, achèvement de l’onglet Shell (uip completion), vue --output table colorée et aide intégrée à chaque commande (uip <cmd> --help).
• Agents de codage - le système uip skills installe des compétences UiPath dans des agents de codage afin qu'ils sachent comment créer, déployer et exploiter des automatisations UiPath avec uip — et pas seulement quelles commandes existent. Agents pris en charge: Claude Code, Cursor, GitHub Copilot, Coded, OpenCode, UiPath Autopilot, Kiro (Amazon Q), garde-fous, At/Save et Devin.

uip skills install récupère le catalogue complet de compétences UiPath à partir de GitHub et l'installe dans un ou plusieurs agents de codage. Vous choisissez les agents cibles (pas des compétences individuelles - l'agent lui-même décide quelle compétence s'applique à une tâche donnée) soit en transmettant --agent <name> , soit de façon interactive à partir d'une invite de case à cocher lorsque l'indicateur est omis. Par défaut, l'installation est globale; ajouter --local pour étendre les compétences au projet actuel (où l'agent le prend en charge — Claude Code est global uniquement, par exemple).

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

Les mêmes commandes fonctionnent dans les deux sens. Une uip invocation qu'un développeur saisit par la main est exactement la même que celle effectuée par un agent, ce qui signifie que votre équipe peut créer une automatisation de manière interactive, diriger la séquence exacte vers un script et la transmettre à un agent d'IA pour l'itérer davantage.

La sortie est JSON par défaut - la même sur un ordinateur portable développeur et dans un pipeline, les scripts n'ont donc pas besoin de se ramifier selon qu'ils s'exécutent ou non interactivement. Ajoutez --output table pour la vue conviviale, --output yaml pour YAML ou --output plain pour key=value lignes. Le filtrage JMESPath est disponible via --output-filter "Data[*].Name".

Comment la UiPath CLI est organisée

uip est un petit hôte avec un système de plug-in. L’hôte gère l’authentification, la gestion des sessions, la configuration et le cycle de vie de l’outil. Tout le reste - Orchestrator, Solution, Agent, Flux, Maestro, RPA, Test Manager, etc. - est fourni sous forme d'outil installable sur npm.

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

Exemples :

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 nouveau npm install -g @uipath/cli contient uniquement les commandes d'hôte et de base - aucun outil n'est préinstallé. La première fois que vous invoquez une commande dont le préfixe correspond à un outil de la liste blanche, l’hôte installe automatiquement cet outil à partir de npm. Vous pouvez également installer des outils explicitement avec uip tools install <name> , ce qui est utile pour la préparation hors ligne et les runtimes CI. Voir Outils pour plus de détails.

Outils intégrés

Les outils ci-dessous sont les principales interfaces d'automatisation de la plate-forme, chacun sur la liste blanche d'installation automatique - il suffit de saisir le préfixe. Les préfixes affichés sont les noms canoniques tels que définis dans l’hôte. Il s’agit d’un sous-ensemble représentatif, et non la liste complète: la UiPath CLI fournit plus de 30 outils en liste blanche au total, couvrant toutes les activités d’Orchestrator vers la gouvernance, la configuration LLM et Process Mining. Voir Outils ( plugins ) pour la table complète et exacte (synchronisée avec la liste blanche de l'hôte), ou la référence de commande pour la page d'alias et de référence de chaque outil.

Outil	Préfixe	Objectif
Orchestrator	or	Tâches, dossiers, processus, packages, machines, utilisateurs, rôles, licences, flux, ressources, files d'attente, compartiments de stockage, bibliothèques, déclencheurs, webhooks
Solution	solution	Élaborer, compresser, publier, télécharger, déployer des solutions UiPath
RPA	rpa	Empaquetage de projets Studio, analyseur de workflow, restauration des dépendances
RPA héritée	rpa-legacy	Le wrapper uniquement Windows autour de uipcli.exe pour les commandes Studio n’est pas encore portée à l’outil rpa multiplate-forme
Agent (Agent)	agent	Création, packaging, déploiement, exécution de l’agent low-code
Agent codé	codedagent	Agents codés basés sur Python
Application codée	codedapp	Projets d'application Web codées
Maestro	maestro	Création/empaquetage/exécution du processus BPMN, plus les branches flow et case (voir la note ci-dessous)
Test Manager	tm	Cas de test, ensembles de test, exécutions, résultats, rapports
Integration Service	is	Connecteurs et connexions
Solutions verticales	vss	Élaboration et génération de solutions verticales
Workflow d’API	api-workflow	Exécution locale des workflows de l’API UiPath
Data Fabric	df	Opérations de Data Fabric
Insights	insights	Tableaux de bord et rapports Insights
Traçages	traces	Traçages et diagnostics de l’exécution
DocsAI	docsai	Recherche de documentation UiPath optimisée par l’IA
Évaluation	eval	Évaluation du runtime des packages déployés par rapport à un processus Orchestrator — un package autonome, pas une sous-commande de or

Astuce :

Exécutez uip --help pour voir les préfixes exacts dans votre installation et uip tools list pour voir quels outils sont actuellement installés. Seuls les outils @uipath/ listés ci-dessus sont pris en charge dans UiPath CLI 1.x; n’est pas encore disponible. Maestro Flow et Case ne sont pas des outils distincts sur la liste blanche. @uipath/maestro-tool est le seul package de la liste blanche pour maestro; il importe directement @uipath/flow-tool et @uipath/case-tool comme ses propres dépendances pour enregistrer les branches uip maestro flow et uip maestro case. L'installation de maestro-tool extrait les deux - il n'existe pas de déclencheur d'installation automatique distinct pour flow ou case.

Vue d’ensemble de l’authentification

La UiPath CLI prend en charge cinq flux d'authentification. Le flux interactif est nouveau dans la version 1.x; L’authentification d’application externe et de variable d’environnement a des homologues dans la CLI.NET héritée; les informations d’identification fédérées sont destinées aux configurations d’identité de la charge de travail qui ne peuvent pas contenir un secret de longue durée; Les informations d’identification du Robot sont destinées à Studio Desktop et aux autres contextes hébergés par le Robot.

Flux	Quand l’utiliser	Comment l’utiliser
Connexion de l’utilisateur OAuth2 interactive (nouveau dans 1.x)	Des développeurs travaillent depuis un terminal. Lie la session à votre compte personnel et à ses autorisations.	uip login ouvre un navigateur pour se connecter et sélectionne un locataire. Les jetons de session sont stockés et actualisés automatiquement.
Application externe (informations d’identification du client)	Pipelines CI/CD, serveurs, tout contexte non interactif. Lie la session à une application externe que vous créez dans UiPath, avec des étendues explicites.	uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant <name> — le préfixe env.VAR lit le secret d’une variable d’environnement sans l’exposer sur la ligne de commande.
Informations d’identification fédérées (identité de la charge de travail)	Plateformes CI/CD qui peuvent émettre leurs propres jetons OIDC (par exemple, une configuration de l’identité de la charge de travail des actions GitHub ou Azure DevOps) — aucun secret de client longue durée à stocker ou à faire pivoter.	uip login --client-id <app-id> --client-assertion env.OIDC_TOKEN — un JWT OIDC remplace la clé secrète du client. Nécessite --client-id; mutuellement exclusif avec --client-secret.
Authentification variable d'environnement	Conteneurs et exécuteurs éphémères qui détiennent déjà un jeton d'accès UiPath. Aucun navigateur, aucun aller-retour par application externe, aucun état sur disque.	Définissez UIPATH_CLI_ENABLE_ENV_AUTH=true et fournissez UIPATH_CLI_AUTH_TOKEN + variables d'organisation/de locataire. Chaque commande uip s'authentifie à partir des variables d'environnement; il n'y a pas d'actualisation.
Identifiants de connexion du Robot	Studio Desktop et d'autres contextes hébergés par le Robot UiPath, s'authentifiant via le Robot déjà exécuté sur la machine.	Définissez UIPATH_CLI_ENFORCE_ROBOT_AUTH=true. S’authentifie exclusivement via le canal IPC du robot local; s'excluent mutuellement avec l'authentification variable d'environnement.

Les trois premiers flux conservent tous une session dans un dossier d’informations d’identification. --profile <name> (un indicateur global — voir Options globales) nomme une session afin que plusieurs connexions puissent coexister côte à côte, indépendamment du flux qui les a créées; transmettez le même --profile sur les commandes ultérieures pour réutiliser cette session spécifique.

Voir Authentification pour le flux complet, la sélection du locataire, la disposition du dossier d'informations d’identification et la marche à suivre pour préconfigurer les External Apps pour CI.

UiPath CLI versus CLI.NET héritée

Aspect	UiPath CLI (uip, 1.x)	CLI .NET hérité (uipcli, 2025.10 et versions antérieures)
Runtime	Node.js (multiplate-forme)	.NET 8 (Windows d'abord)
Distribution	npm install -g @uipath/cli	.nupkg par rapport au flux MyGet/NuGet
Contrôle de version	Contrôle de version sémantique (1.0.0, 1.1.0, ...)	Contrôle des versions du calendrier (2023.10, 2024.10, 2025.10)
Portée	Créer, gérer, exploiter et déployer sur l’ensemble de la plate-forme	Concentré sur CI/CD — compresser, analyser, déployer, exécuter des tests
Authentification	OAuth2 interactif (uip login) et Application externe (informations d’identification du client)	Application externe (informations d’identification du client), plus l’authentification de base/jeton obsolète
Architecture	Outils modulaires, installés automatiquement lors de la première utilisation à partir de npm	Exécutable monobloc
Formats de sortie	table, json, yaml, plain avec JMESPath filtrage	Texte/JSON (limité)
Intégration de l’IA	Système de compétences pour le codage des agents	Non disponible
Analyseur de workflow	Conservé sous la forme uip rpa analyze, avec prise en charge de la politique de fichier de gouvernance	Livré avec la CLI (uipcli package analyze)
Restauration de la dépendance	Conservé sous la forme uip rpa restore, avec prise en charge de l'interface physiquement isolée et de la configuration NuGet	Livré avec la CLI (uipcli package restore)

Si vous démarrez un nouveau pipeline aujourd'hui, utilisez UiPath CLI 1.x. Si vous conservez les pipelines Azure DevOps ou Jenkins existants basés sur uipcli.exe, consultez le guide de migration pour la carte de commande, les changements de nom d’indicateur et les changements radicaux.

UiPath CLI versus plug-ins CI/CD

UiPath CLI (uip) est l' outil. L'extension Azure DevOps, le plug-in Jenkins et les intégrations de pipeline similaires sont des encapsuleurs autour de cet outil - ils regroupent les invocations de uip derrière des formulaires de tâches pilotés par l'interface utilisateur, l'injection sécurisée de variables et la journalisation native du pipeline. À l'avenir, les versions plus récentes de ces plug-ins appelleront uip en interne.

Utilisez le plug-in lorsque vous souhaitez l'interface utilisateur du pipeline et la gestion des variables. Utilisez uip directement (via une étape bash ou pwsh ) lorsque vous souhaitez les dernières fonctionnalités de la CLI sans attendre la publication du plug-in, ou lorsque vous avez besoin d'une commande que le plug-in n'expose pas.

Voir Intégrations CI/CD pour la documentation du plug-in.

Plateformes prises en charge

UiPath CLI 1.x s'exécute sur n'importe quelle plate-forme qui prend en charge Node.js 22 ou une version ultérieure:

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

Stabilité et cadence de publication

La UiPath CLI suit le contrôle de version sémantique:

• MAJOR — rupture des modifications apportées aux noms de commande, à la sémantique des indicateurs ou à l'enveloppe JSON. Un cycle d’obsolescence précède toute version majeure.
• mineur — nouvelles commandes, nouveaux indicateurs, nouveaux outils; ajout uniquement. Notez que la forme de Data dans la sortie JSON est spécifique à la commande et peut changer dans les versions mineures; les pipelines doivent épingler @uipath/cli.
• PATCH — corrections de bogues; aucun changement de comportement documenté.

Les commandes et outils individuels sont libellés en disponibilité générale, en aperçu public ou obsolètes. Les commandes d’aperçu peuvent changer sans augmentation de version majeure; les commandes obsolètes continuent de fonctionner pendant au moins un cycle MAJOR. Voir Contrôle des versions et stabilité pour le contrat complet.

Prochaines étapes

• Installez la UiPath CLI — configurée uip sur Windows, macOS ou Linux.
• Démarrage rapide : connectez-vous, répertoriez les dossiers Orchestrator et exécutez une tâche en cinq minutes.
• Votre premier pipeline : compressez un projet et déployez-le à partir d'un pipeline CI.
• Utilisation de l'UiPath CLI avec des agents de codage : installez des compétences dans Claude Code, Cursor, GitHub Copilot ou tout autre agent pris en charge et laissez-les créer des automatisations UiPath avec uip.
• Référence de commande — référence complète pour chaque commande.
• Migration depuis la CLI.NET héritée — si vous venez de uipcli.exe.