ug CLI-referentie

Gebruik de Unity Gateway CLI (ug) om codeeragenten te configureren en te starten. Voor een walkthrough, zie de quickstart van de coderingsagent.

Install

Installeer ugen controleer dan de geïnstalleerde versie:

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

Voor de vereisten, zie de quickstart-vereisten.

Configure

Command	Wat het doet
ug configure	Log in op een Azure Databricks werkruimte en configureer je agenten met de instellingen van je admin of de begeleide setup.
ug configure --workspace https://your-workspace.databricks.com	Stel je agenten zo in dat ze de werkruimte gebruiken op de opgegeven URL.
ug configure --profile <name> --use-pat	Authenticeer met een persoonlijk toegangstoken in plaats van OAuth. Voer databricks configure --host <workspace-url> eerst uit om je token op te slaan in een configuratieprofiel, en geef dat profiel dan door met --profile (bijvoorbeeld, --profile DEFAULT). Het profiel geeft de URL van de werkruimte.

Stuur een agent

Deze commando's openen de agent in je terminal, klaar voor je gebruikelijke codeerworkflow.

Command	Wat het doet
ug	Start de agent die geselecteerd is door de gepubliceerde workspace-configuratie van je admin.
ug claude	Start Claude Code via Unity Gateway.
ug codex	Start Codex via Unity Gateway.
ug gemini	Start Gemini CLI via Unity Gateway.
ug opencode	Start OpenCode via Unity Gateway.
ug copilot	Start GitHub Copilot CLI via Unity Gateway.
ug pi	Start Pi via Unity Gateway.
ug cursor	Start Cursor Agent. Modelverzoeken gebruiken je Cursor-account.

Voor Claude Code of Codex voeg je de werkruimte-authenticatie, modellen en configuratie toe --refresh voordat je start. Je kunt ook agent-specifieke argumenten doorgeven aan het launch-commando.

MCP-servers

Command	Wat het doet
ug mcp add	Selecteer MCP-servers en voeg hun verbindingen toe aan je geconfigureerde agenten.
ug mcp list	Toon geconfigureerde MCP-servers en de status die door elke agent wordt gerapporteerd.
ug mcp remove	Selecteer MCP-verbindingen die je van je agenten wilt verwijderen. De servers blijven in de werkruimte.

Skills

Command	Wat het doet
ug skills add	Selecteer gepubliceerde vaardigheden en download hun bestanden in lokale agentenvaardigheidsgidsen.
ug skills add --via mcp	Verbind vaardigheden uit geselecteerde Unity Catalog-schema's via MCP, zonder bestanden te downloaden.
ug skills list	Laat de vaardigheden zien die voor je agenten zijn ingesteld en hoe ze zijn toegevoegd.
ug skills remove	Selecteer gedownloade vaardighedenmappen om van je computer te verwijderen. De gepubliceerde vaardigheden blijven ongewijzigd.
ug skills remove --via mcp	Verwijder geselecteerde schema's uit de MCP-verbinding van het vaardigheidsregister. Gedownloade vaardigheidsbestanden worden bewaard.

Voor benoemde servers en vaardigheden, schemaselectie en projectdownloads, zie Gereedschappen en vaardigheden toevoegen.

Beheer je setup

Command	Wat het doet
ug usage	Toon je huidige uitgaven, totale budget en percentage gebruikt.
ug doctor	Controleer de lokale installatie en agentconfiguratie en bied oplossingen aan voor gevonden problemen.
ug upgrade	Installeer de nieuwste Unity Gateway CLI-versie van GitHub.
ug export	Print de opgeslagen codeeragentconfiguratie van je admin als JSON voor hergebruik.
ug revert	Herstel de geback-upte agentconfiguratiebestanden en maak de opgeslagen setupstatus van ug's schoon.

Commando-hulp

Gebruik --help om de opties voor je geïnstalleerde versie te bekijken:

Command	Wat het doet
ug --help	Toon beschikbare commando's en algemene opties.
ug configure --help	Toon opties voor werkruimte en agent-instellingen.
ug skills add --help	Toon opties om vaardigheden te downloaden of ze via MCP te verbinden.