> ## 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 os arquivos da aplicação pela CLI

> Liste, leia, grave, mova e exclua arquivos de uma aplicação da Square Cloud em execução com squarecloud app file, sem commit. Arquivos binários chegam intactos.

O `squarecloud app file` é um gerenciador de arquivos remoto: ele altera os arquivos direto na aplicação, sem commit. Todo subcomando recebe a aplicação com `--app <appID>`, que é opcional: veja [como a CLI encontra sua aplicação](/pt-br/cli-reference/quickstart#como-a-cli-encontra-sua-aplicação).

O `read` e o `write` transferem arquivos binários sem alteração.

## `squarecloud app file list`

```bash Uso theme={"system"}
squarecloud app file list [path] [--app <appID>] [--json]
```

Lista uma pasta da aplicação (a raiz, quando você omite o `path`): tipo, nome, tamanho e última modificação.

```bash theme={"system"}
squarecloud app file list /logs --app <appID>
# Lista a pasta logs de uma aplicação específica.
```

## `squarecloud app file read`

```bash Uso theme={"system"}
squarecloud app file read <path> [-o <local file>] [-y] [--app <appID>]
```

| Flag | Descrição |
| - | - |
| `-o`, `--output <local file>` | Salva o conteúdo em um arquivo local em vez de imprimi-lo. Pergunta antes de sobrescrever um arquivo existente. |
| `-y`, `--yes` | Sobrescreve um arquivo local existente sem perguntar. |
| `--app <appID>` | A aplicação de onde ler. |

```bash theme={"system"}
squarecloud app file read config.json
# Imprime o arquivo no stdout.
```

```bash theme={"system"}
squarecloud app file read config.json -o ./config.backup.json
# Salva o arquivo localmente.
```

Um arquivo local novo criado pelo `-o` só pode ser lido por você (permissões 0600), já que arquivos de aplicações costumam guardar segredos.

## `squarecloud app file write`

```bash Uso theme={"system"}
squarecloud app file write <path> [--from <local file>] [--app <appID>]
```

| Flag | Descrição |
| - | - |
| `--from <local file>` | Lê o conteúdo de um arquivo local. Sem ela, o conteúdo vem do stdin. |
| `--app <appID>` | A aplicação onde gravar. |

Cria o arquivo, ou o sobrescreve quando ele existe.

```bash theme={"system"}
squarecloud app file write config.json --from ./config.json
```

```bash theme={"system"}
cat ./config.json | squarecloud app file write config.json --app <appID>
# Grava o stdin como conteúdo do arquivo.
```

## `squarecloud app file move`

```bash Uso theme={"system"}
squarecloud app file move <path> <new path> [--app <appID>]
```

**Aliases:** `mv`, `rename`

```bash theme={"system"}
squarecloud app file mv old-name.txt new-name.txt
```

## `squarecloud app file delete`

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

**Aliases:** `rm`

| Flag | Descrição |
| - | - |
| `-y`, `--yes` | Pula a confirmação. |
| `--app <appID>` | A aplicação a alterar. |

Pede uma confirmação `y/N` e depois exclui o arquivo.

```bash theme={"system"}
squarecloud app file rm old-log.txt -y
```

## Relacionados

| Comando | API | SDK JavaScript |
| - | - | - |
| `list` | [`GET .../files`](/pt-br/api-reference/endpoint/apps/filemanager/list) | [`api.apps.files.list()`](/pt-br/sdks/js/managing_files) |
| `read` | [`GET .../files/content`](/pt-br/api-reference/endpoint/apps/filemanager/content) | [`api.apps.files.read()`](/pt-br/sdks/js/managing_files) |
| `write` | [`PUT .../files`](/pt-br/api-reference/endpoint/apps/filemanager/put) | [`api.apps.files.write()`](/pt-br/sdks/js/managing_files) |
| `move` | [`PATCH .../files`](/pt-br/api-reference/endpoint/apps/filemanager/patch) | [`api.apps.files.move()`](/pt-br/sdks/js/managing_files) |
| `delete` | [`DELETE .../files`](/pt-br/api-reference/endpoint/apps/filemanager/delete) | [`api.apps.files.delete()`](/pt-br/sdks/js/managing_files) |

Para enviar uma pasta inteira de uma vez, use o [`squarecloud commit`](/pt-br/cli-reference/deploy#squarecloud-commit).