Referência ao CLI do ug

Use a CLI do Gateway Unity (ug) para configurar e lançar agentes de codificação. Para um guia, veja o quickstart do agente de codificação.

Install

Instale, ugdepois verifique a versão instalada:

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

Exige uv Python 3.12 ou posterior.

Configure

Command	O que faz
ug configure	Faça login em um espaço de trabalho do Azure Databricks e configure seus agentes usando as configurações do seu administrador ou configuração guiada.
ug configure --workspace https://your-workspace.databricks.com	Configure seus agentes para usar o espaço de trabalho na URL especificada.
ug configure --profile <name> --use-pat	Autentique com um token de acesso pessoal em vez de OAuth. Primeiro, execute databricks configure --host <workspace-url> para salvar seu token em um perfil de configuração, depois passe esse perfil com --profile (por exemplo, --profile DEFAULT). O perfil fornece a URL do espaço de trabalho.

Lançar um agente

Esses comandos abrem o agente no seu terminal, pronto para seu fluxo de trabalho habitual de codificação.

Command	O que faz
ug	Inicie o agente selecionado pela configuração de espaço de trabalho publicada pelo seu administrador.
ug claude	Inicie o Claude Code pelo Unity Gateway.
ug codex	Iniciar o Codex pelo Unity Gateway.
ug gemini	Inicie a CLI Gemini através do Unity Gateway.
ug opencode	Inicie o OpenCode pelo Unity Gateway.
ug copilot	Inicie a CLI do GitHub Copilot através do Unity Gateway.
ug pi	Inicie o Pi pelo Unity Gateway.
ug cursor	Iniciar o Agente do Cursor. Solicitações de modelo usam sua conta Cursor.

Para Código Claude ou Codex, adicione --refresh à atualização autenticação do workspace, modelos e configuração antes de lançar. Você também pode passar argumentos específicos de agente para o comando de lançamento.

Servidores MCP

Command	O que faz
ug mcp add	Selecione servidores MCP e adicione suas conexões aos seus agentes configurados.
ug mcp list	Mostre servidores MCP configurados e o status reportado por cada agente.
ug mcp remove	Selecione conexões MCP para remover dos seus agentes. Os servidores permanecem no espaço de trabalho.

Habilidades

Command	O que faz
ug skills add	Selecione as habilidades publicadas e baixe os arquivos deles em diretórios de habilidades de agentes locais.
ug skills add --via mcp	Conecte habilidades de esquemas selecionados do Catálogo Unity através do MCP, sem precisar baixar arquivos.
ug skills list	Mostre as habilidades configuradas para seus agentes e como elas foram adicionadas.
ug skills remove	Selecione pastas de habilidades baixadas para excluir do seu computador. As habilidades publicadas permanecem inalteradas.
ug skills remove --via mcp	Remova esquemas selecionados da conexão MCP do registro de habilidades. Arquivos de habilidades baixados são mantidos.

Para servidores e habilidades nomeadas, seleção de esquemas e downloads de projetos, veja Adicionar ferramentas e habilidades.

Gerencie sua configuração

Command	O que faz
ug usage	Mostre seus gastos atuais, orçamento total e porcentagem utilizada.
ug doctor	Verifique a instalação local e a configuração do agente, e ofereça correções para os problemas encontrados.
ug upgrade	Instale a versão mais recente da CLI do Unity Gateway a partir do GitHub.
ug export	Imprima a configuração salva do seu administrador como JSON para reutilização.
ug revert	Restaure os arquivos de configuração do agente com backup e limpe ugo estado de configuração salvo do Agent Save.

Ajuda do comando

Use --help para ver as opções da sua versão instalada:

Command	O que faz
ug --help	Mostre os comandos disponíveis e as opções gerais.
ug configure --help	Mostrar opções de configuração de workspace e agente.
ug skills add --help	Mostre opções para baixar habilidades ou conectá-las pelo MCP.