---
{
  "title": "Workflowy CLI",
  "intro": "Utilisez Workflowy depuis votre terminal, vos scripts et vos agents IA."
}
---

Workflowy CLI (`wf`) est une boîte à outils en ligne de commande open source permettant de lire, rechercher, organiser et modifier votre compte Workflowy. Elle comprend un cache local pour un accès rapide, des commandes d’automatisation, des résultats lisibles par machine pour les scripts et les agents, ainsi qu’un serveur MCP intégré.

Vous trouverez le code source et les dernières versions dans le [dépôt GitHub de Workflowy CLI](https://github.com/rodolfo-terriquez/workflowy-cli).

# Ce que vous pouvez faire

- Lire et rechercher dans votre compte Workflowy depuis un terminal
- Ajouter, mettre à jour, déplacer, compléter et supprimer des éléments
- Utiliser des emplacements intégrés comme `@inbox`, `@today` et `@tomorrow`
- Utiliser des signets et des chemins pour cibler des parties précises de votre compte
- Exporter des structures, trouver des tâches et des mots-clés, et consulter les modifications récentes
- Connecter plusieurs comptes Workflowy et conserver un cache local distinct pour chacun
- Renvoyer du JSON structuré pour les scripts et les agents IA
- Connecter directement à Workflowy des outils d’IA compatibles avec MCP

# Ce dont vous avez besoin

- Une clé API Workflowy depuis [workflowy.com/api-key](https://workflowy.com/api-key/)
- Un terminal sur macOS, Linux ou Windows

# Installer la CLI

## macOS et Linux

Copiez-collez cette commande dans votre terminal :

```bash
curl -fsSL https://github.com/rodolfo-terriquez/workflowy-cli/releases/latest/download/install.sh | bash
```

## Windows

Copiez-collez cette commande dans PowerShell :

```powershell
irm https://github.com/rodolfo-terriquez/workflowy-cli/releases/latest/download/install.ps1 | iex
```

Le programme d’installation détecte votre système d’exploitation et votre processeur, télécharge la dernière version précompilée et ajoute la commande `wf` à votre PATH lorsque cela est possible.

# Connecter votre compte Workflowy

Exécutez ces commandes après l’installation :

```bash
wf login
wf cache:sync
wf doctor
```

`wf login` vous demande votre clé API Workflowy sans l’afficher. `wf cache:sync` télécharge une copie locale de votre structure pour accélérer les lectures et les recherches. `wf doctor` vérifie votre connexion, votre configuration, votre cache et votre installation.

# Commencer à utiliser la CLI

Lisez un emplacement ou recherchez dans votre compte :

```bash
wf node:read @inbox
wf node:read @today --depth 3
wf search "quarterly planning"
wf targets
```

Ajoutez et gérez des éléments :

```bash
wf node:add @inbox "Draft project brief" --type todo
wf node:complete "@inbox/Draft project brief"
wf node:move "@today/Review roadmap" @inbox
wf node:update "@inbox/Follow up" --note "Waiting on a reply"
```

Les commandes qui acceptent une cible peuvent utiliser un emplacement intégré, un signet renvoyé par `wf targets`, un ID d’élément ou un chemin comme `@today/Meetings/Launch review`.

Exécutez `wf --help` pour afficher la liste complète des commandes, ou ajoutez `--help` après une commande pour voir ses options.

# Maintenir les résultats locaux à jour

La plupart des commandes de lecture et de recherche utilisent automatiquement le cache SQLite local. Synchronisez-le chaque fois que vous souhaitez obtenir la copie la plus récente de votre compte Workflowy :

```bash
wf cache:sync
```

Pour une requête ponctuelle qui doit ignorer le cache, utilisez `--live` avec les commandes compatibles :

```bash
wf node:read @inbox --live
wf search "launch notes" --live
```

# Connecter plusieurs comptes

Donnez à chaque compte un nom local court lorsque vous vous connectez :

```bash
wf login --account personal
wf login --account work
wf account:list
wf account:switch work
wf account:current
```

Chaque compte conserve son propre cache local. Vous pouvez sélectionner un compte pour une seule commande sans modifier votre compte par défaut :

```bash
wf --account personal cache:sync
wf --account work node:add @inbox "Follow up with the team"
```

# Utiliser la CLI avec des scripts et des agents IA

Ajoutez `--agent` pour obtenir du JSON lisible par machine avec des résultats et des erreurs structurés :

```bash
wf search "project roadmap" --agent
wf node:read @today --depth 3 --agent
```

La CLI comprend également un serveur MCP local :

```bash
wf mcp
```

Configurez votre client MCP pour exécuter le binaire `wf` installé avec l’argument `mcp`. Exécutez d’abord `wf login` et `wf cache:sync` afin que le serveur utilise le même compte et le même cache que la CLI. Consultez le [README de Workflowy CLI](https://github.com/rodolfo-terriquez/workflowy-cli#readme) pour des exemples de configuration et des options MCP avancées.

# Mettre à jour la CLI

Recherchez ou installez une nouvelle version avec :

```bash
wf self:update --check
wf self:update
```

# Sécurité et résolution des problèmes

- Utilisez l’invite interactive de `wf login` pour éviter que votre clé API soit enregistrée dans l’historique du shell.
- Si les résultats de recherche semblent obsolètes, exécutez `wf cache:sync` ou utilisez `--live`.
- Si une commande utilise le mauvais compte, vérifiez `wf account:current` et changez de compte avec `wf account:switch <name>`.
- Si `wf` est introuvable après l’installation, ouvrez un nouveau terminal et vérifiez que le répertoire d’installation se trouve dans votre PATH.
- Exécutez `wf doctor` pour vérifier l’installation, l’authentification, la configuration et le cache.
- Pour signaler des bugs ou demander des fonctionnalités, consultez les [problèmes GitHub](https://github.com/rodolfo-terriquez/workflowy-cli/issues) du dépôt.