Référence CLI 1.9.2
Résoudre un problème avec la CLI¶
La commande deposium est introuvable¶
Vérifie Node.js, le préfixe npm global et l'emplacement de la commande dans le même terminal :
Dans PowerShell, utilise Get-Command deposium à la place de command -v deposium.
Avec Node.js ^22.13.0 ou >=24, réinstalle la CLI :
Le dossier des exécutables npm globaux doit être accessible dans le PATH de ton terminal. Si tu viens de modifier le PATH, ouvre un nouveau terminal. Avec mise ou un autre gestionnaire Node.js, vérifie aussi la version Node.js sélectionnée : ses paquets globaux peuvent être différents.
Une ancienne version s'affiche après la mise à jour¶
Compare la version exécutée, la version publiée et l'emplacement de l'installation :
Dans PowerShell, remplace la dernière commande par Get-Command deposium.
Une autre installation peut être prioritaire dans le PATH, notamment après un changement de version Node.js. Sélectionne la version Node.js souhaitée et relance npm install -g @deposium/cli@latest dans le même terminal. Quitte ensuite les sessions Deposium déjà ouvertes et relance-les.
Une installation npm ne met pas à jour un checkout Git local ni toutes les installations Node.js de ta machine.
Aucune mise à jour n'est proposée¶
Le mécanisme de démarrage nécessite une CLI 1.6.0 ou ultérieure, installée globalement avec npm. Il concerne uniquement deposium, chat et interactive / i dans un terminal interactif avec entrée et sortie TTY.
Il est désactivé pour l'aide, --version, les sorties JSON, les autres commandes, la CI, Bun, npm link, le développement et npx. Hors ligne, la vérification peut échouer sans message. Pour vérifier et mettre à jour manuellement, suis le guide des mises à jour.
La connexion échoue¶
Crée ou renouvelle une clé utilisateur dans Facturation → Clés API, puis utilise l'invite interactive :
Vérifie que tu utilises le compte qui a accès aux espaces voulus. La CLI est préconfigurée pour Deposium en ligne ; aucune URL de serveur n'est nécessaire. Ne publie jamais ta clé dans une capture, un ticket ou des logs partagés.
Mes documents ne sont pas trouvés¶
Dans l'application, vérifie que les documents sont dans l'espace voulu et que leur traitement est terminé. Liste ensuite les espaces accessibles :
Remplace VOTRE_ESPACE_ID par l'identifiant réel de l'espace. Pour une conversation, relance deposium chat et sélectionne cet espace.
Pour examiner une commande précise, utilise deposium <commande> --help ou la référence des commandes.
La démo UI ne démarre pas¶
demo-ui.ts est un exemple pour les développeurs du CLI, pas une commande
Desktop ni un fichier du paquet npm global. ERR_MODULE_NOT_FOUND en lançant
npx tsx demo-ui.ts depuis deposium_desktop indique le mauvais répertoire.
Dans un checkout CLI existant à jour (sources 1.7.2 ou suivantes), lance :
Le changement de dossier ci-dessus suppose que tu pars du checkout Desktop
voisin. Sinon, ouvre directement le dossier deposium_CLI contenant
package.json et demo-ui.ts. Pour un nouveau checkout de développement :
Les anciennes sources importaient des fonctions supprimées : changer de dossier
ou installer tsx seul ne suffit pas, il faut mettre les sources à jour.
La démo utilise des données fictives, sans API, modèle ou état réel de tes services.
Pour utiliser le CLI normalement, lance deposium i ; cette démo n'est pas nécessaire.