Référence CLI ug

Utilisez la ligne de commande Unity Gateway (ug) pour configurer et lancer des agents de codage. Pour un guide, consultez le quickstart de l’agent de codage.

Install

Installez ug, puis vérifiez la version installée :

uv tool install git+https://github.com/databricks/unity-gateway
ug --version

Pour les exigences, consultez les prérequis de démarrage rapide.

Configure

Command	Qu’est-ce que cela fait ?
ug configure	Connectez-vous à un espace de travail Azure Databricks et configurez vos agents en utilisant les paramètres de votre administrateur ou la configuration guidée.
ug configure --workspace https://your-workspace.databricks.com	Configurez vos agents pour utiliser l’espace de travail à l’URL spécifiée.
ug configure --profile <name> --use-pat	Authentifiez avec un jeton d’accès personnel au lieu d’un OAuth. D’abord, lance databricks configure --host <workspace-url> pour enregistrer ton jeton dans un profil de configuration, puis passe ce profil avec --profile (par exemple, --profile DEFAULT). Le profil fournit l’URL de l’espace de travail.

Lancez un agent

Ces commandes ouvrent l’agent dans votre terminal, prêt pour votre flux de travail de codage habituel.

Command	Qu’est-ce que cela fait ?
ug	Lancez l’agent sélectionné par la configuration de l’espace de travail publiée par votre administrateur.
ug claude	Lancez Claude Code via Unity Gateway.
ug codex	Lancez le Codex via Unity Gateway.
ug gemini	Lancez la ligne de commande Gemini via Unity Gateway.
ug opencode	Lancez OpenCode via Unity Gateway.
ug copilot	Lancez la CLI de GitHub Copilot via Unity Gateway.
ug pi	Lancez Pi via Unity Gateway.
ug cursor	Lancez l’agent du curseur. Les demandes de modèles utilisent votre compte Cursor.

Pour Claude Code ou Codex, ajoutez --refresh à rafraîchir l’authentification de l’espace de travail, les modèles et la configuration avant le lancement. Vous pouvez aussi transmettre des arguments spécifiques à l’agent à la commande de lancement.

Serveurs MCP

Command	Qu’est-ce que cela fait ?
ug mcp add	Sélectionnez les serveurs MCP et ajoutez leurs connexions à vos agents configurés.
ug mcp list	Affichez les serveurs MCP configurés et le statut rapporté par chaque agent.
ug mcp remove	Sélectionnez les connexions MCP à retirer de vos agents. Les serveurs restent dans l’espace de travail.

Compétences

Command	Qu’est-ce que cela fait ?
ug skills add	Sélectionnez les compétences publiées et téléchargez leurs fichiers dans les annuaires locaux des agents.
ug skills add --via mcp	Reliez des compétences issues de schémas sélectionnés du catalogue Unity via MCP, sans télécharger de fichiers.
ug skills list	Montrez les compétences configurées pour vos agents et comment elles ont été ajoutées.
ug skills remove	Sélectionnez les dossiers de compétences téléchargés pour les supprimer de votre ordinateur. Les compétences publiées restent inchangées.
ug skills remove --via mcp	Supprimez les schémas sélectionnés de la connexion MCP du registre de compétences. Les fichiers de compétences téléchargés sont conservés.

Pour les serveurs et compétences nommés, la sélection de schémas et les téléchargements de projets, voir Ajouter des outils et compétences.

Gérez votre installation

Command	Qu’est-ce que cela fait ?
ug usage	Affichez vos dépenses actuelles, votre budget total et le pourcentage utilisé.
ug doctor	Vérifiez votre installation locale et la configuration de votre agent, et proposez des solutions pour les problèmes rencontrés.
ug upgrade	Installez la dernière version de la CLI de Unity Gateway depuis GitHub.
ug export	Imprimez la configuration de l’agent de codage sauvegardé de votre administrateur en JSON pour la réutilisation.
ug revert	Restaurez les fichiers de configuration de l’agent sauvegardés et effacez ugl’état de configuration sauvegardé.

Aide au commandement

Utilisez --help pour voir les options pour votre version installée :

Command	Qu’est-ce que cela fait ?
ug --help	Affichez les commandes disponibles et les options générales.
ug configure --help	Affichez les options de configuration de l’espace de travail et des agents.
ug skills add --help	Montre des options pour télécharger des compétences ou les connecter via MCP.