Workflowy CLI

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.

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
• Un terminal sur macOS, Linux ou Windows

Installer la CLI

macOS et Linux

Copiez-collez cette commande dans votre terminal :

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

Windows

Copiez-collez cette commande dans 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 :

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 :

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

Ajoutez et gérez des éléments :

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 :

wf cache:sync

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

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

Connecter plusieurs comptes

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

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 :

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 :

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

La CLI comprend également un serveur MCP local :

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 pour des exemples de configuration et des options MCP avancées.

Mettre à jour la CLI

Recherchez ou installez une nouvelle version avec :

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 du dépôt.