> ## 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.

# Gerencie aplicações pela CLI

> Liste suas aplicações da Square Cloud, veja os detalhes, inicie, pare ou reinicie cada uma e exclua as que você não usa mais com squarecloud app.

O `[appID]` é opcional em todos os comandos desta página, exceto no `list`: veja [como a CLI encontra sua aplicação](/pt-br/cli-reference/quickstart#como-a-cli-encontra-sua-aplicação).

## `squarecloud app list`

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

Imprime uma tabela com todas as aplicações da sua conta: nome, ID da aplicação, memória, cluster, linguagem e domínio (o domínio personalizado, quando existe um).

```bash theme={"system"}
squarecloud app list --json
# Imprime a lista bruta de aplicações em JSON.
```

## `squarecloud app info`

```bash Uso theme={"system"}
squarecloud app info [appID] [--json]
```

Mostra o ID da aplicação, nome, descrição, linguagem, memória, cluster, dono, domínio, domínio personalizado e data de criação.

```bash theme={"system"}
squarecloud app info <appID> --json
# Imprime o objeto bruto da aplicação em JSON.
```

## `squarecloud app start`

```bash Uso theme={"system"}
squarecloud app start [appID]
```

Inicia uma aplicação parada.

```bash Saída theme={"system"}
✓ Signal START has been successfully sent to your application.
```

Se a aplicação já estiver rodando, a CLI avisa (`It is already running.`) e sai com código 0. Outras recusas da plataforma aparecem como erros.

## `squarecloud app stop`

```bash Uso theme={"system"}
squarecloud app stop [appID]
```

Para uma aplicação em execução. Se ela já estiver parada, a CLI avisa (`It is already stopped.`) e sai com código 0.

## `squarecloud app restart`

```bash Uso theme={"system"}
squarecloud app restart [appID]
```

Reinicia o processo da aplicação. Para enviar código novo e reiniciar em um só passo, use [`squarecloud commit --restart`](/pt-br/cli-reference/deploy#squarecloud-commit).

## `squarecloud app delete`

```bash Uso theme={"system"}
squarecloud app delete [appID] [-y]
```

| Flag | Descrição |
| - | - |
| `-y`, `--yes` | Pula a confirmação. |

<Warning>
  Excluir uma aplicação é permanente, e a CLI não cria um snapshot antes. Para guardar uma cópia, execute [`squarecloud app snapshot create --download`](/pt-br/cli-reference/snapshots#squarecloud-app-snapshot-create) antes de excluir.
</Warning>

Pergunta `Delete the application <appID>? This action is irreversible [y/N]` antes de excluir. Sem um ID, o comando age sobre a aplicação da linha `ID=` da pasta atual, então confira o ID na pergunta.

```bash theme={"system"}
squarecloud app delete <appID> -y
# Exclui sem perguntar, para scripts.
```

```bash Saída theme={"system"}
✓ Your application has been deleted.
```

## Relacionados

| Comando | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `list` | [`GET /v2/users/me`](/pt-br/api-reference/endpoint/users/me) | [`api.account.me()`](/pt-br/sdks/js/client) | [Barra lateral](/pt-br/vscode-extension/features#aplicações) |
| `info` | [`GET /v2/apps/{app_id}`](/pt-br/api-reference/endpoint/apps/info) | [`api.apps.get()`](/pt-br/sdks/js/managing_application) | Clique no cartão de uma aplicação |
| `start` | [`POST .../start`](/pt-br/api-reference/endpoint/apps/start) | [`api.apps.start()`](/pt-br/sdks/js/managing_application) | [Iniciar](/pt-br/vscode-extension/features#aplicações) |
| `stop` | [`POST .../stop`](/pt-br/api-reference/endpoint/apps/stop) | [`api.apps.stop()`](/pt-br/sdks/js/managing_application) | [Parar](/pt-br/vscode-extension/features#aplicações) |
| `restart` | [`POST .../restart`](/pt-br/api-reference/endpoint/apps/restart) | [`api.apps.restart()`](/pt-br/sdks/js/managing_application) | [Reiniciar](/pt-br/vscode-extension/features#aplicações) |
| `delete` | [`DELETE /v2/apps/{app_id}`](/pt-br/api-reference/endpoint/apps/delete) | [`api.apps.delete()`](/pt-br/sdks/js/managing_application) | [Excluir](/pt-br/vscode-extension/features#aplicações) |