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

# Gestionar los archivos de una app desde la CLI

> Lista, lee, escribe, mueve y elimina archivos de una aplicación de Square Cloud en ejecución con squarecloud app file, sin commit. Los binarios llegan intactos.

`squarecloud app file` es un gestor de archivos remoto: modifica los archivos de la aplicación directamente, sin un commit. Todos los subcomandos reciben la aplicación con `--app <appID>`, que es opcional: consulta [cómo encuentra la CLI tu aplicación](/es/cli-reference/quickstart#cómo-encuentra-la-cli-tu-aplicación).

`read` y `write` transfieren los archivos binarios sin cambios.

## `squarecloud app file list`

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

Lista una carpeta de la aplicación (la raíz cuando omites `path`): tipo, nombre, tamaño y última modificación.

```bash theme={"system"}
squarecloud app file list /logs --app <appID>
# Lista la carpeta logs de una app específica.
```

## `squarecloud app file read`

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

| Flag | Descripción |
| - | - |
| `-o`, `--output <local file>` | Guarda el contenido en un archivo local en lugar de mostrarlo. Pregunta antes de sobrescribir un archivo existente. |
| `-y`, `--yes` | Sobrescribe un archivo local existente sin preguntar. |
| `--app <appID>` | La aplicación de la que se lee. |

```bash theme={"system"}
squarecloud app file read config.json
# Muestra el archivo en stdout.
```

```bash theme={"system"}
squarecloud app file read config.json -o ./config.backup.json
# Lo guarda en local.
```

Un archivo local nuevo creado por `-o` solo puedes leerlo tú (permisos 0600), ya que los archivos de las aplicaciones suelen contener secretos.

## `squarecloud app file write`

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

| Flag | Descripción |
| - | - |
| `--from <local file>` | Lee el contenido de un archivo local. Sin él, el contenido viene de stdin. |
| `--app <appID>` | La aplicación en la que se escribe. |

Crea el archivo, o lo sobrescribe cuando 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>
# Escribe stdin como el contenido del archivo.
```

## `squarecloud app file move`

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

**Alias:** `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>]
```

**Alias:** `rm`

| Flag | Descripción |
| - | - |
| `-y`, `--yes` | Omite la confirmación. |
| `--app <appID>` | La aplicación que se va a modificar. |

Pide una confirmación `y/N` y luego elimina el archivo.

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

## Relacionado

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

Para enviar una carpeta completa en un solo paso, usa [`squarecloud commit`](/es/cli-reference/deploy#squarecloud-commit).