> ## 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. # Referencia de CLI > Usa Glasser desde tu terminal. Instala, inicia sesión y encuentra el comando que necesitas. Busca, inspecciona y ejecuta Endpoints de API de pago con una sola Key: las mismas tres llamadas que en la API, desde la terminal. ## Instalación Requiere Node.js 22 o posterior; npm es opcional. Vuelve a ejecutar cualquiera de los dos comandos para actualizar. ```bash theme={null} curl -fsSL https://glasser.ai/install.sh | sh # or, with npm: npm install -g @glasser-ai/cli ``` ## Autenticación Ejecuta este comando para abrir el inicio de sesión en el navegador y guardar una Key para tu Workspace: ```bash theme={null} glasser login ``` Aprueba solo cuando el código del navegador coincida con el de la terminal. Consulta [glasser login](https://glasser.ai/docs/es/cli/login.md) para ver las opciones de inicio de sesión. Para CI y scripts, crea una Key en la consola y establece `GLASSER_API_KEY`, o usa [glasser keys add](https://glasser.ai/docs/es/cli/keys/add.md). ## Comandos Elige un comando en la barra lateral o abre su referencia a continuación. Cada página de comando muestra su sintaxis y sus opciones. | Comando | Descripción | | - | - | | [`glasser login`](https://glasser.ai/docs/es/cli/login) | Inicia sesión mediante el navegador y guarda una Key. | | [`glasser search`](https://glasser.ai/docs/es/cli/search) | Busca Endpoints ejecutables o explora Data Sources. | | [`glasser inspect`](https://glasser.ai/docs/es/cli/inspect) | Inspecciona un Endpoint antes de ejecutarlo. | | [`glasser run`](https://glasser.ai/docs/es/cli/run) | Ejecuta un Endpoint y recupera su salida. | | [`glasser runs list`](https://glasser.ai/docs/es/cli/runs/list) | Enumera Runs y filtra los resultados. | | [`glasser runs get`](https://glasser.ai/docs/es/cli/runs/get) | Obtiene un Run, espera a que termine o guarda su salida. | | [`glasser runs stop`](https://glasser.ai/docs/es/cli/runs/stop) | Solicita detener un Run. | | [`glasser balance`](https://glasser.ai/docs/es/cli/balance) | Consulta tu saldo y verifica tu Key. | | [`glasser balance history`](https://glasser.ai/docs/es/cli/balance/history) | Enumera los movimientos del saldo. | | [`glasser keys add`](https://glasser.ai/docs/es/cli/keys/add) | Guarda una Key en este equipo. | | [`glasser keys list`](https://glasser.ai/docs/es/cli/keys/list) | Enumera las Keys guardadas. | | [`glasser keys activate`](https://glasser.ai/docs/es/cli/keys/activate) | Cambia la Key activa. | | [`glasser keys remove`](https://glasser.ai/docs/es/cli/keys/remove) | Elimina una Key de este equipo. | | [`glasser skill install`](https://glasser.ai/docs/es/cli/skill/install) | Guarda Skill para que las nuevas sesiones de agentes la carguen. | ## Mantener las llamadas en un solo Task Una búsqueda devuelve un `task_id`. Pasa ese valor con `--task` en las búsquedas relacionadas, incluidos los reintentos con palabras diferentes y las solicitudes de la página siguiente, así como en `inspect` y `run`. La CLI no almacena ni reutiliza Task automáticamente. Cada búsqueda sigue requiriendo `--use-case`, incluso cuando pasas `--task`. ```bash theme={null} glasser search "company enrichment" --use-case "Prepare a company profile" ``` Sustituye `` a continuación por el `task_id` de esa respuesta. Usa el proveedor de datos, el Endpoint y la entrada seleccionados mediante la búsqueda y la inspección. ```bash theme={null} glasser inspect -p -e --task glasser run -p -e -i '' --task glasser runs list --task ``` Omitir `--task` inicia un Task nuevo en cada búsqueda. En `inspect` y `run`, omitirlo deja la llamada sin Task. En `runs list`, `--task` filtra los resultados para ese Task. ## Opciones globales Opciones globales en cada comando: `-j/--json`, `--help`, `--version`. ## Modo JSON Con `-j/--json`, los resultados del comando en stdout son JSON. Stderr está vacío cuando la operación se realiza correctamente y contiene un objeto de error JSON cuando falla. Las solicitudes explícitas de `--help` y `--version` siguen generando texto. * `run --json` requiere `--idempotency-key` para que puedas reintentar con la misma key. * `keys remove --json` requiere `--force` para omitir la confirmación interactiva. * `login --json` es un error de uso porque el inicio de sesión es interactivo. * `--output` guarda solo el campo de salida del Run. Si la escritura se realiza correctamente, stdout contiene el Run completo. Si falla la escritura del archivo, stdout queda vacío, se escribe un objeto JSON `io_error` en stderr y el proceso termina con `1`. El modo JSON no muestra mensajes de estado del archivo en stderr. Para `run` y `runs get`, stdout sigue devolviendo un Run `FAILED` o `STOPPED`. El comando también escribe un error JSON en stderr y termina con el código `1`. Las cantidades monetarias en los campos de respuesta de Glasser son cadenas decimales exactas, nunca números de coma flotante. ## Códigos de salida | Código | Significado | | - | - | | `0` | Correcto | | `1` | Error de API, red o E/S local; tiempo de espera agotado; o `run` / `runs get` devolvió un Run `FAILED` o `STOPPED` | | `2` | Error de uso: opciones o entrada incorrectas; el comando nunca llegó a la API | | `130` | Interrumpido (Ctrl-C) | Para `run` y `runs get`, el código de salida `0` puede indicar que el Run aún está `QUEUED` o `RUNNING` cuando no usas `--wait`. Un Run `COMPLETED` también termina con `0` cuando el proveedor de datos devuelve HTTP 4xx o 5xx; consulta `provider_response.http_status`. El estado del Run y `charge_usd` son resultados independientes. `runs stop` termina con `0` cuando se acepta la solicitud de detención, aunque el Run siga ejecutándose. Consulta [detener un Run](https://glasser.ai/docs/es/cli/runs/stop.md) para conocer el comportamiento completo. ## Variables de entorno | Variable | Significado | | - | - | | `GLASSER_API_KEY` | Una Key para esta invocación; sustituye el almacén de claves local | | `GLASSER_API_BASE_URL` | Origen de la API (predeterminado [https://api.glasser.ai](https://api.glasser.ai)) | | `NO_COLOR` | Desactiva el color en el texto de ayuda y versión que muestra el framework de CLI | ## Para agentes Skill orientada a agentes en [glasser.ai/SKILL.md](https://glasser.ai/SKILL.md) incluye esta CLI: cuándo usarla, cómo autenticarse mediante `glasser login` y las reglas para mantener el gasto bajo control. Indica a tu agente que use ese archivo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.