> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Flags globales, códigos de salida y CI

> Flags globales, salida JSON, códigos de salida y depuración de la CLI de Square Cloud: revisa el estado de la plataforma y úsala en scripts y CI.

## `squarecloud help`

```bash Uso theme={"system"}
squarecloud help [command]
squarecloud [command] --help
```

Lista todos los comandos, o explica uno. La ayuda sigue el [idioma de tu sistema](/es/cli-reference/installation#idioma).

```bash Salida theme={"system"}
A command line application to manage your Square Cloud applications

Usage:
  squarecloud COMMAND [flags]
  squarecloud [command]

Available Commands:
  app         Manage your applications with these commands
  auth        Manage your Square Cloud login with these commands
  commit      Make a commit for your application
  db          Manage the databases of your account
  help        Help about any command
  status      Check the Square Cloud platform health
  upload      Upload a new application
  workspace   Manage your team workspaces
  zip         Zip the current folder

Flags:
  -h, --help      Show help for this command
      --json      Output raw JSON
  -v, --version   Print the CLI version

Use "squarecloud [command] --help" for more information about a command.
```

## Flags globales

| Flag | Descripción |
| - | - |
| `--json` | Muestra una salida JSON sin procesar y legible por máquina en los comandos que muestran datos (`list`, `info`, `status`, `logs`, `auth whoami`, `upload`, ...). Los comandos sin salida JSON (`app start`, `app delete`, `commit`, `zip`, ...) rechazan el flag con un error. |
| `-h`, `--help` | Muestra la ayuda de cualquier comando. |
| `-v`, `--version` | Muestra la versión de la CLI. Solo en `squarecloud` en sí. |

Los comandos destructivos también aceptan `-y`/`--yes` para omitir su confirmación `y/N`. Las páginas de cada comando lo indican.

## `squarecloud status`

```bash Uso theme={"system"}
squarecloud status [--json]
```

Comprueba si la plataforma Square Cloud funciona con normalidad. Funciona sin iniciar sesión. Para una aplicación o base de datos concreta, usa [`squarecloud app status`](/es/cli-reference/status-and-metrics#squarecloud-app-status) o [`squarecloud db status`](/es/cli-reference/databases#squarecloud-db-status).

```bash Salida theme={"system"}
✓ <status message>
```

Cuando la plataforma informa de un problema, la línea empieza con `X` en su lugar. Consulta también la [página de estado](https://status.squarecloud.app/).

## Depuración

* Define **`SQUARECLOUD_DEBUG=1`** para registrar cada solicitud a la API en stderr: método, ruta, estado y duración. Los encabezados, las query strings y los cuerpos nunca se registran, así que la salida es segura para compartir.
* Las solicitudes de lectura se reintentan automáticamente después de un error de red o cuando la plataforma está ocupada por un momento.
* **Ctrl+C** cancela la solicitud en curso; un segundo Ctrl+C sale de un comando que está esperando una entrada.

```bash theme={"system"}
SQUARECLOUD_DEBUG=1 squarecloud app list
```

## Scripts y CI

La CLI se comporta de forma predecible cuando se ejecuta sin una persona frente al teclado:

* **Autenticación:** define `SQUARECLOUD_API_KEY` en lugar de ejecutar `auth login`. Consulta [Autenticación](/es/cli-reference/authentication#ci-y-scripts).
* **Pasa los IDs de forma explícita.** Los selectores de aplicaciones y bases de datos necesitan una terminal. Consulta [cómo encuentra la CLI tu aplicación](/es/cli-reference/quickstart#cómo-encuentra-la-cli-tu-aplicación).
* **Códigos de salida:** todo fallo sale con código `1`, incluso cuando la CLI se instaló mediante npm. Comprueba los códigos de salida, no el texto de los mensajes.
* **Las confirmaciones fallan en modo seguro.** Responder que no, o ejecutar sin una terminal y sin `-y` un comando que pide confirmación, sale con código `1` y no cambia nada. Los comandos que preguntan son `app delete`, `app env replace`, `app env remove --all`, `app file delete`, `app file read -o` sobre un archivo existente, `app network purge-cache`, `app snapshot restore`, `db delete`, `db snapshot restore`, `db credentials reset`, `workspace delete`, `workspace leave`, `workspace member remove`, y `auth login` cuando reemplazaría la clave de otra cuenta.
* **stdout solo lleva resultados.** Los errores, el aviso de que no hay sesión iniciada, las preguntas de confirmación, las líneas de fallo y el aviso de actualización van a stderr. Con `upload --json`, los mensajes de progreso también van a stderr.
* **Analiza `--json`, no las tablas.** En sistemas que no están en inglés, los encabezados de las tablas y las etiquetas de `info` se traducen. Para forzar el inglés, ejecuta con `LC_ALL=en_US.UTF-8`.
* **Estar ya en ese estado es un éxito.** Si inicias una app o base de datos que ya está en ejecución, o detienes una que ya está detenida, la CLI lo indica y sale con código `0`.

Para hacer deploy desde GitHub Actions, consulta el [workflow de deploy automático](https://help.squarecloud.app/es/article/workflow-github-actions-deploy-automatico-h2c5n4/) del centro de ayuda.

## Relacionado

| Comando | API | SDK de JavaScript |
| - | - | - |
| `status` | [`GET /v2/service/status`](/es/api-reference/endpoint/service/status) | [`api.service.status()`](/es/sdks/js/client) |