NAQUADA
Ouvrir Naquada
Parcours vérifiable

Naquada dans votre IDE

Installer l’extension Naquada pour VS Code

Connectez Codex à l’Orchestrateur Naquada, validez un plan puis recevez images, vidéos, sons et fichiers 3D directement au chemin demandé dans votre projet.

Avant de commencer

L’extension pilote la CLI Rust locale. Les deux composants sont nécessaires.

  • VS Code 1.96 ou une version plus récente.
  • Un compte Naquada accessible sur la production.
  • La CLI Naquada installée et disponible avec la commande naquada.
  • Codex dans VS Code si vous voulez lancer les pipelines depuis le chat.

Vérification

Résultat visible : naquada --version répond dans le terminal intégré.

Installer les deux composants

1

Installer la CLI

Suivez d’abord le guide correspondant à macOS, Windows ou Linux. La CLI conserve la session dans le coffre sécurisé du système.

Guide de la CLI Naquada →
2

Installer l’extension

Installez « Naquada for Codex » depuis la Marketplace, puis rechargez VS Code.

Lien de distribution non configuré

La page est prête, mais l’opérateur doit définir NEXT_PUBLIC_NAQUADA_VSCODE_MARKETPLACE_URL avec la fiche officielle avant publication. N’installez pas un paquet provenant d’un autre éditeur.
VS Code CLI
code --install-extension naquada.naquada-vscode
3

Vérifier l’installation

Une icône Naquada apparaît dans la barre d’activité. La palette de commandes contient « Naquada : se connecter ».

Connecter le projet et Codex

1

Se connecter

Ouvrez la palette (⇧⌘P sur macOS, Ctrl+Shift+P sur Windows/Linux), lancez « Naquada : se connecter », puis approuvez le code dans le navigateur.

Terminal
naquada login
2

Lier le dossier courant

Lancez « Naquada : lier ce projet ». Donnez un nom et un tag stables. Naquada crée uniquement le dossier local .naquada et un contexte distant lié au compte.

Terminal
naquada project link --name "Mon projet" --tag mon-projet
3

Déclarer Naquada à Codex

Lancez « Naquada : connecter Codex via MCP », confirmez, puis rechargez la fenêtre. Le même résultat est disponible depuis la CLI.

Terminal
naquada setup codex --apply

Contrôle concret

Dans Codex, ouvrez la liste MCP : le serveur naquada est activé et ses outils de planification sont visibles.

Créer un premier asset sans quitter VS Code

Demandez un résultat précis et donnez toujours un chemin relatif de destination. Codex prépare le plan ; l’exécution payante ne part qu’après la validation prévue par vos réglages.

Prompt Codex
Utilise Naquada pour créer une icône pixel art de coffre magique, fond transparent, 512 × 512. Enregistre l’original dans assets/generated/chest.png. Montre-moi le plan et le coût estimé avant l’exécution.

Relisez le modèle, la configuration, les entrées, le coût estimé et surtout assets/generated/chest.png, puis validez.

Résultat attendu, vérifiable à l’œil

  • L’exécution apparaît dans la vue « Naquada — Exécutions et assets ».
  • Le reçu local indique le tool Naquada appelé, le plan approuvé et le chemin final.
  • Le fichier assets/generated/chest.png existe et s’ouvre dans VS Code.
  • Le hash du fichier livré est présent dans .naquada/runs/<run-id>.json.

Comprendre où vont les fichiers

Le chemin donné à Naquada est toujours relatif à la racine du projet ouvert.

  • .naquada/runs/ conserve les reçus nécessaires au suivi et à la reprise.
  • .naquada/assets/ est un tampon temporaire pendant une livraison ; ce n’est pas une bibliothèque synchronisée.
  • Le fichier vérifié est déplacé vers le chemin final demandé par l’IA.
  • Les références locales ne sont envoyées que lorsqu’un fichier précis ou un dossier autorisé est explicitement désigné.

Collision de nom

Si l’IA exige explicitement le remplacement, Naquada remplace le fichier. Sinon, image.png devient par exemple image-02.png. Aucun fichier du projet n’est écrasé implicitement.

Ce que Naquada ne fait jamais implicitement

La confiance du workspace VS Code et le consentement explicite restent obligatoires pour les actions sensibles.

  • Aucun scan ni envoi du dépôt complet.
  • Aucune récupération automatique de votre bibliothèque en ligne.
  • Aucune commande Git, aucun commit et aucune modification de branche.
  • Aucun téléchargement d’asset sans run approuvé et reçu local.
  • La session utilisateur interactive est stockée dans le trousseau macOS, le Gestionnaire d’identifiants Windows ou le Secret Service Linux.

Fermer VS Code sans perdre une génération

Les générations continuent côté Naquada. L’extension ne bloque pas le chat pendant l’attente.

  • Après redémarrage, l’extension relit uniquement les reçus déjà approuvés dans .naquada/runs/.
  • Elle reprend le téléchargement incomplet et vérifie le SHA-256.
  • Une notification confirme le rangement final ou signale une reprise nécessaire.
  • Vous pouvez relancer manuellement « Reprendre la livraison » depuis la vue Naquada.

Diagnostiquer en moins d’une minute

Lancez « Naquada : diagnostiquer l’intégration » ou la commande suivante.

Terminal
naquada --json doctor
  • authenticated doit valoir true.
  • projectLinked doit valoir true.
  • apiReachable doit valoir true.
  • gitTouched doit toujours valoir false.

Résultat

Quand ok vaut true, le compte, le projet, l’API de production et les dossiers de reprise sont prêts.