CLI dwa

dwa est l’outil en ligne de commande de DWA, pensé d’abord pour les agents locaux et les scripts : synchroniser les thèmes de l’organisation, contrôler une présentation, l’exporter en PowerPoint, valider et publier un thème. Un seul exécutable, sans Node ni autre prérequis (Chrome, Chromium ou Edge du poste sert au rendu).

disponible Linux (x86-64, statique) et Windows (x86-64).

Installation

Une ligne, comme uv :

# Linux, WSL
curl -LsSf https://marp.yassine-hadi.net/install.sh | sh

# Windows (PowerShell)
irm https://marp.yassine-hadi.net/install.ps1 | iex

L’exécutable est placé dans ~/.local/bin (Windows : %LOCALAPPDATA%\dwa\bin, ajouté au PATH), après vérification de son empreinte SHA-256. Variables : DWA_INSTALL_DIR (autre dossier), DWA_NO_MODIFY_PATH=1 (Windows : PATH inchangé).

Mise à jour :

dwa self update

Commandes

Commande	Rôle
dwa auth login --portal <adresse>	Connexion par le navigateur (code à autoriser dans le portail), partagée avec l’extension VS Code
dwa auth status / dwa auth logout	Portails connectés ; déconnexion du CLI et de VS Code, session révoquée sur le serveur
dwa sync [--check]	Installe et met à jour les thèmes accessibles, dans le dossier commun avec VS Code
dwa check presentation.md	Structure du langage et débordements mesurés dans Chromium
dwa check theme.css	Les six étapes du validateur des thèmes
dwa export presentation.md	PowerPoint éditable, fidèle au thème, polices intégrées
dwa version publish theme.css --version 1.2.0	Valide puis publie une version, comme l’éditeur du portail
dwa self update	Dernière version du CLI

Toutes les commandes acceptent --json. Aucune question hors terminal ; codes de sortie stables : 0 succès, 1 erreur, 2 usage, 3 refusé par le validateur, 4 connexion requise, 5 droits insuffisants.

$ dwa check bilan.md
bilan.md:14  slide 2  erreur  Le contenu dépasse la zone utile de la slide. Réduire le texte, utiliser medium/small ou répartir sur plusieurs slides.
bilan.md:16  slide 2  erreur  Du texte dépasse la zone utile de la slide.
2 erreur(s) sur 2 slides.
$ echo $?
3

Connexion partagée avec VS Code

Le CLI et l’extension lisent le même dossier (%LOCALAPPDATA%\dwa, ou le dossier Windows depuis WSL ; DWA_HOME pour un autre) : se connecter dans l’un connecte l’autre, et les thèmes synchronisés servent aux deux. Le jeton est chiffré sur le poste ; les droits sont toujours contrôlés par le serveur.