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

# Gérer les fichiers d'une app depuis la CLI

> Listez, lisez, écrivez, déplacez et supprimez les fichiers d'une application Square Cloud avec squarecloud app file, sans commit, binaires compris.

`squarecloud app file` est un gestionnaire de fichiers distant : il modifie les fichiers directement dans l'application, sans commit. Chaque sous-commande prend l'application avec `--app <appID>`, qui est facultatif : consultez [comment la CLI trouve votre application](/fr/cli-reference/quickstart#comment-la-cli-trouve-votre-application).

`read` et `write` transfèrent les fichiers binaires sans modification.

## `squarecloud app file list`

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

Liste un dossier de l'application (la racine si vous omettez `path`) : type, nom, taille et dernière modification.

```bash theme={"system"}
squarecloud app file list /logs --app <appID>
# Liste le dossier logs d'une app précise.
```

## `squarecloud app file read`

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

| Option | Description |
| - | - |
| `-o`, `--output <local file>` | Enregistre le contenu dans un fichier local au lieu de l'afficher. Demande confirmation avant d'écraser un fichier existant. |
| `-y`, `--yes` | Écrase un fichier local existant sans demander. |
| `--app <appID>` | L'application à lire. |

```bash theme={"system"}
squarecloud app file read config.json
# Affiche le fichier sur stdout.
```

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

Un nouveau fichier local créé par `-o` n'est lisible que par vous (permissions 0600), car les fichiers d'une application contiennent souvent des secrets.

## `squarecloud app file write`

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

| Option | Description |
| - | - |
| `--from <local file>` | Lit le contenu depuis un fichier local. Sans elle, le contenu provient de stdin. |
| `--app <appID>` | L'application dans laquelle écrire. |

Crée le fichier, ou l'écrase s'il 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>
# Écrit stdin comme contenu du fichier.
```

## `squarecloud app file move`

```bash Utilisation 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 Utilisation theme={"system"}
squarecloud app file delete <path> [-y] [--app <appID>]
```

**Alias :** `rm`

| Option | Description |
| - | - |
| `-y`, `--yes` | Ignore l'invite de confirmation. |
| `--app <appID>` | L'application à modifier. |

Demande une confirmation `y/N`, puis supprime le fichier.

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

## Voir aussi

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

Pour envoyer tout un dossier en une seule étape, utilisez [`squarecloud commit`](/fr/cli-reference/deploy#squarecloud-commit).