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

# squarecloud app file

> Gerencia os arquivos remotos da sua aplicação na Square Cloud.

Um gerenciador de arquivos remoto para sua aplicação: liste, leia, escreva, mova e delete arquivos sem um commit. Todo subcomando recebe o ID da aplicação com `--app`; quando omitido, a CLI recorre ao arquivo de configuração `squarecloud.app` no diretório atual, e por fim a um seletor interativo.

```bash theme={null}
squarecloud app file list
# Lista os arquivos na raiz da aplicação.
```

```bash theme={null}
squarecloud app file list /logs --app <appID>
# Lista os arquivos em um diretório específico de uma aplicação específica.
```

```bash theme={null}
squarecloud app file list --json
# Imprime a lista bruta de arquivos como JSON.
```

```bash theme={null}
squarecloud app file read config.json --app <appID>
# Imprime o conteúdo do arquivo no stdout.
```

```bash theme={null}
squarecloud app file read config.json -o ./local-config.json --app <appID>
# Salva o conteúdo do arquivo em um arquivo local em vez de imprimi-lo.
```

```bash theme={null}
cat ./config.json | squarecloud app file write config.json --app <appID>
# Escreve o stdin como conteúdo do arquivo, criando-o ou sobrescrevendo-o.
```

```bash theme={null}
squarecloud app file write config.json --from ./local-config.json --app <appID>
# Escreve o conteúdo de um arquivo local em vez de ler do stdin.
```

```bash theme={null}
squarecloud app file move old-name.txt new-name.txt --app <appID>
# Move ou renomeia um arquivo. Aliases: "mv", "rename".
```

```bash theme={null}
squarecloud app file delete old-log.txt --app <appID>
# Deleta um arquivo. Alias: "rm".
```

O subcomando `delete` é destrutivo: ele pede confirmação `y/N` antes de remover o arquivo. Passe `-y`/`--yes` para pular a confirmação.

Use `squarecloud app file --help` para mais informações sobre este comando.