CLI public · API v1

Piloter DemioFlow depuis le terminal

Installez le package public, autorisez votre terminal dans le navigateur, puis gérez espaces, projets, sections, tâches, objectifs, habitudes et tags.

Architecture sûre. En production, le CLI passe par https://app.demioflow.com/v1. Il ne demande jamais votre mot de passe et n’accède pas directement à Firestore.

Installation et connexion

Node.js 20 ou plus récent suffit. Le canal alpha reçoit les fonctions récentes avant la version stable.

npm install --global demioflow@alpha
demioflow --version
demioflow auth

La commande affiche un code temporaire et ouvre DemioFlow dans votre navigateur. Vérifiez que le même code est visible, connectez-vous si nécessaire, puis autorisez le terminal. Le code n’est pas un secret et expire rapidement.

demioflow auth status
demioflow auth logout

Espaces, projets et sections

La hiérarchie principale est Espace → Projet → Section → Tâche. Une section appartient toujours à un projet ; une tâche peut cibler une section du même projet.

demioflow areas list
demioflow projects list --area AREA_ID
demioflow sections list --project PROJECT_ID
demioflow sections create --project PROJECT_ID --name "En cours"
demioflow tasks create --title "Préparer la maquette" --project PROJECT_ID --section SECTION_ID

Les commandes retournent des identifiants stables. Utilisez --json pour les scripts et --help après une ressource ou une action pour les options exactes.

Déplacer et réordonner

demioflow projects move PROJECT_ID --area AREA_ID
demioflow projects reorder --area AREA_ID --ids PROJECT_1,PROJECT_2
demioflow sections move SECTION_ID --project PROJECT_ID
demioflow sections reorder --project PROJECT_ID --ids SECTION_1,SECTION_2
demioflow tasks move TASK_ID --project PROJECT_ID --section SECTION_ID
demioflow tasks move TASK_ID --project PROJECT_ID --section root
demioflow tasks reorder --ids TASK_1,TASK_2

Commandes disponibles

Ressource	Actions
areas	list, get, create, update, archive, default
projects	list, get, create, update, archive, complete, move, reorder
sections	list, get, create, update, delete, move, collapse, expand, reorder
tasks	list, get, create, update, complete, reopen, delete, duplicate, move, reorder, plan, unplan
goals	list, get, create, update, complete, archive, progress
habits	list, get, create, update, archive, restore, log, toggle, increment
tags	list, get, create, update, delete, move, reorder, link, unlink

Exemples utiles

demioflow tasks list --project PROJECT_ID --json
demioflow tasks complete TASK_ID
demioflow goals progress GOAL_ID --value 42
demioflow habits log HABIT_ID --date 2026-08-11 --value 1
demioflow sections collapse SECTION_ID
demioflow sections expand SECTION_ID

Pour l’automatisation, combinez --json avec jq. Les erreurs sont écrites sur stderr et utilisent un code de sortie non nul.

demioflow --json tasks list | jq -r '.[].title'

Tags hiérarchiques

demioflow tags create --name "Prioritaire" --color "#6B57D8"
demioflow tags move TAG_ID --parent PARENT_TAG_ID
demioflow tags move TAG_ID --parent root
demioflow tags reorder --parent root --ids TAG_1,TAG_2
demioflow tags link TAG_ID --type task --entity TASK_ID
demioflow tags unlink TAG_ID --type task --entity TASK_ID

Mettre le CLI à jour

npm install --global demioflow@alpha

Vous pouvez vérifier la version installée avec demioflow --version. Le package reste public ; l’accès à vos données dépend toujours de votre autorisation DemioFlow.