> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Referência da CLI > Use o Glasser pelo terminal. Instale, faça login e encontre o comando necessário. Pesquise, inspecione e execute endpoints de API pagos com uma única Key — as mesmas três chamadas da API, a partir do terminal. ## Instalação Requer Node.js 22 ou mais recente; o npm é opcional. Execute novamente qualquer um dos comandos para atualizar. ```bash theme={null} curl -fsSL https://glasser.ai/install.sh | sh # or, with npm: npm install -g @glasser-ai/cli ``` ## Autenticação Execute este comando para abrir o login no navegador e armazenar uma Key para seu Workspace: ```bash theme={null} glasser login ``` Aprove somente quando o código no navegador corresponder ao do terminal. Consulte [glasser login](https://glasser.ai/docs/pt/cli/login.md) para ver as opções de login. Para CI e scripts, crie uma Key no console e defina `GLASSER_API_KEY`, ou use [glasser keys add](https://glasser.ai/docs/pt/cli/keys/add.md). ## Comandos Escolha um comando na barra lateral ou abra sua referência abaixo. Cada página de comando lista sua sintaxe e suas opções. | Comando | Descrição | | - | - | | [`glasser login`](https://glasser.ai/docs/pt/cli/login) | Faça login pelo navegador e armazene uma Key. | | [`glasser search`](https://glasser.ai/docs/pt/cli/search) | Pesquise Endpoints executáveis ou navegue pelas Data Sources. | | [`glasser inspect`](https://glasser.ai/docs/pt/cli/inspect) | Inspecione um Endpoint antes de executá-lo. | | [`glasser run`](https://glasser.ai/docs/pt/cli/run) | Execute um Endpoint e recupere sua saída. | | [`glasser runs list`](https://glasser.ai/docs/pt/cli/runs/list) | Liste Runs e filtre os resultados. | | [`glasser runs get`](https://glasser.ai/docs/pt/cli/runs/get) | Obtenha um Run, aguarde a conclusão ou salve sua saída. | | [`glasser runs stop`](https://glasser.ai/docs/pt/cli/runs/stop) | Solicite a interrupção de um Run. | | [`glasser balance`](https://glasser.ai/docs/pt/cli/balance) | Consulte seu saldo e verifique sua Key. | | [`glasser balance history`](https://glasser.ai/docs/pt/cli/balance/history) | Liste as movimentações do saldo. | | [`glasser keys add`](https://glasser.ai/docs/pt/cli/keys/add) | Armazene uma Key nesta máquina. | | [`glasser keys list`](https://glasser.ai/docs/pt/cli/keys/list) | Liste as Keys armazenadas. | | [`glasser keys activate`](https://glasser.ai/docs/pt/cli/keys/activate) | Alterne a Key ativa. | | [`glasser keys remove`](https://glasser.ai/docs/pt/cli/keys/remove) | Remova uma Key desta máquina. | | [`glasser skill install`](https://glasser.ai/docs/pt/cli/skill/install) | Salve o Skill para que novas sessões de agentes o carreguem. | ## Mantenha as chamadas em um único Task Uma pesquisa retorna um `task_id`. Passe esse valor com `--task` em pesquisas relacionadas, incluindo novas tentativas com palavras diferentes e solicitações da próxima página, e em `inspect` e `run`. A CLI não armazena nem reutiliza o Task automaticamente. Cada pesquisa ainda exige `--use-case`, mesmo quando você passa `--task`. ```bash theme={null} glasser search "company enrichment" --use-case "Prepare a company profile" ``` Substitua `` abaixo pelo `task_id` dessa resposta. Use o Provider, o Endpoint e a entrada selecionados durante a pesquisa e a inspeção. ```bash theme={null} glasser inspect -p -e --task glasser run -p -e -i '' --task glasser runs list --task ``` Omitir `--task` inicia um novo Task a cada pesquisa. Em `inspect` e `run`, omiti-lo deixa a chamada sem um Task. Em `runs list`, `--task` filtra os resultados para esse Task. ## Flags globais Flags globais em todos os comandos: `-j/--json`, `--help`, `--version`. ## Modo JSON Com `-j/--json`, os resultados dos comandos em stdout são JSON. Stderr fica vazio em caso de sucesso e contém um objeto de erro JSON em caso de falha. Solicitações explícitas de `--help` e `--version` ainda produzem texto. * `run --json` exige `--idempotency-key` para que você possa tentar novamente com a mesma chave. * `keys remove --json` exige `--force` para ignorar a confirmação interativa. * `login --json` é um erro de uso porque o login é interativo. * `--output` salva apenas o campo de saída do Run. Após uma gravação bem-sucedida, stdout contém o Run completo. Uma falha ao gravar o arquivo deixa stdout vazio, grava um objeto JSON `io_error` em stderr e encerra com `1`. O modo JSON não imprime mensagens de status do arquivo em stderr. Para `run` e `runs get`, um Run `FAILED` ou `STOPPED` ainda é retornado em stdout. O comando também grava um erro JSON em stderr e encerra com o código `1`. Os valores monetários nos campos de resposta do Glasser são strings decimais exatas, nunca números de ponto flutuante. ## Códigos de saída | Código | Significado | | - | - | | `0` | Sucesso | | `1` | Falha de API, rede ou E/S local; tempo limite de espera; ou `run` / `runs get` retornou um Run `FAILED` ou `STOPPED` | | `2` | Erro de uso — flags ou entrada inválidas; o comando nunca chegou à API | | `130` | Interrompido (Ctrl-C) | Para `run` e `runs get`, a saída `0` pode significar que o Run ainda está `QUEUED` ou `RUNNING` quando você não usa `--wait`. Um Run `COMPLETED` também termina com `0` quando o Provider retorna HTTP 4xx ou 5xx; verifique `provider_response.http_status`. O status do Run e `charge_usd` são resultados separados. `runs stop` termina com `0` quando a solicitação de interrupção é aceita, mesmo que o Run ainda esteja em execução. Consulte [interrompendo um Run](https://glasser.ai/docs/pt/cli/runs/stop.md) para ver o comportamento completo. ## Variáveis de ambiente | Variável | Significado | | - | - | | `GLASSER_API_KEY` | Uma Key para esta invocação; substitui o armazenamento local de chaves | | `GLASSER_API_BASE_URL` | Origem da API (padrão [https://api.glasser.ai](https://api.glasser.ai)) | | `NO_COLOR` | Desativa as cores no texto de ajuda e de versão renderizado pelo framework da CLI | ## Para agentes O Skill voltado para agentes em [glasser.ai/SKILL.md](https://glasser.ai/SKILL.md) inclui esta CLI — quando usá-la, como se autenticar por meio de `glasser login` e as regras que mantêm os gastos deliberados. Aponte seu agente para esse arquivo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.