Dépannage

Les problèmes les plus courants à l’installation et à la connexion.

command not found: sddvault

Votre terminal a été ouvert avant que le programme d’installation ne mette à jour le PATH. Ouvrez une nouvelle fenêtre de terminal ou rechargez votre shell :

Terminal
exec $SHELL -l

PowerShell lit le PATH au démarrage. Fermez toutes les fenêtres PowerShell et ouvrez-en une nouvelle.

Il n’est pas dans mon PATH

Ajoutez vous-même le dossier d’installation au PATH, puis ouvrez un nouveau terminal.

Terminal
echo 'export PATH="$HOME/.sddvault/bin:$PATH"' >> ~/.zshrc
PowerShell
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:LOCALAPPDATA\sddvault\bin", "User")

Je suis derrière un proxy d’entreprise

Configurez votre proxy avant d’exécuter le programme d’installation. sddvault utilise ensuite les mêmes variables. Utilisez NO_PROXY pour les hôtes à joindre directement.

Terminal
export HTTPS_PROXY=http://proxy.example.com:8080 export NO_PROXY=localhost,.internal.example.com
PowerShell
$env:HTTPS_PROXY = "http://proxy.example.com:8080" $env:NO_PROXY = "localhost,.internal.example.com"

Windows SmartScreen signale une application non signée

Tant que SDD Vault est en bêta, la version Windows n’est pas signée, et SmartScreen peut afficher « Windows a protégé votre ordinateur ». Choisissez Informations complémentaires, puis Exécuter quand même. Ne le faites que si la commande provient de {host}.

L’agent ne voit pas SDD Vault

Redémarrez l’agent après sddvault init. Vérifiez que le fichier de configuration existe (.mcp.json, .cursor/mcp.json ou .vscode/mcp.json) et que son URL contient le slug de votre organisation. Avec un jeton, vérifiez que SDD_VAULT_TOKEN est définie dans l’environnement où l’agent s’exécute.

La session a expiré

Relancez sddvault login. sddvault whoami indique qui est connecté.

Une écriture est refusée avec conflict

Quelqu’un a écrit le document après votre dernière lecture. Lisez la révision courante, fusionnez votre modification et écrivez de nouveau avec cette révision comme expected_revision.

Les appels MCP sont refusés à la limite

Free et Pro ont une limite mensuelle d’appels MCP (plan_mcp_call_limit) qui se réinitialise le premier jour du mois suivant. Voir la politique d’usage raisonnable ou changez d’offre.

Toujours bloqué ? Contactez le support. Nous répondons en général sous un jour ouvré.