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

> Manages the remote files of your application on Square Cloud.

A remote file manager for your application: list, read, write, move and delete files without a commit. Every subcommand takes the application ID with `--app`; when omitted, the CLI falls back to the `squarecloud.app` config file in the current directory, then an interactive picker.

```bash theme={null}
squarecloud app file list
# Lists files at the root of the application.
```

```bash theme={null}
squarecloud app file list /logs --app <appID>
# Lists files in a specific directory of a specific application.
```

```bash theme={null}
squarecloud app file list --json
# Prints the raw file list as JSON.
```

```bash theme={null}
squarecloud app file read config.json --app <appID>
# Prints the file content to stdout.
```

```bash theme={null}
squarecloud app file read config.json -o ./local-config.json --app <appID>
# Saves the file content to a local file instead of printing it.
```

```bash theme={null}
cat ./config.json | squarecloud app file write config.json --app <appID>
# Writes stdin as the file content, creating or overwriting it.
```

```bash theme={null}
squarecloud app file write config.json --from ./local-config.json --app <appID>
# Writes the content of a local file instead of reading from stdin.
```

```bash theme={null}
squarecloud app file move old-name.txt new-name.txt --app <appID>
# Moves or renames a file. Aliases: "mv", "rename".
```

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

The `delete` subcommand is destructive: it asks for `y/N` confirmation before removing the file. Pass `-y`/`--yes` to skip the prompt.

Use `squarecloud app file --help` for more information about this command.
