Aller au contenu

Référence CLI 1.9.2

Version documentée.

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 :

node --version
npm prefix -g
command -v deposium

Dans PowerShell, utilise Get-Command deposium à la place de command -v deposium.

Avec Node.js ^22.13.0 ou >=24, réinstalle la CLI :

npm install -g @deposium/cli@latest

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 :

deposium --version
npm view @deposium/cli version
npm prefix -g
command -v deposium

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 :

deposium auth login
deposium auth status

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 :

deposium space list
deposium search "une phrase de ton document" --space VOTRE_ESPACE_ID

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 :

cd ../deposium_CLI
npm ci
npm run demo:ui

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 :

git clone https://github.com/theseedship/deposium_CLI.git
cd deposium_CLI
npm ci
npm run demo:ui

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.