Aller au contenu

Documentation

Installer Cadralia dans Brave ou Chrome

Installer l'extension, brancher votre agent et livrer votre première structure.

Cadralia s'installe en trois temps : l'extension, le connecteur local, puis le branchement de votre agent. Comptez dix minutes.

Le site, l'extension et les messages de l'API suivent la langue de votre navigateur. Le sélecteur FR / EN de l'en-tête permet de la changer.

Avant de commencer

  • Brave ou Chrome.
  • Node.js 20 ou plus. Vérifiez avec node --version.
  • OpenCode, Codex ou Claude Code installé et fonctionnel.
  • Un compte Cadralia. Le plan Free est gratuit et ne demande pas de carte.

1. Installer l'extension

Installez Cadralia depuis le Chrome Web Store. L'icône apparaît dans la barre : un clic ouvre le panneau latéral.

Si vous utilisez une version distribuée hors store, chargez l'archive de la dernière release dans brave://extensions ou chrome://extensions avec Charger l'extension non empaquetée.

2. Installer le connecteur

Dans un terminal :

npm install -g cadralia-bridge

Sans installation globale, remplacez cadralia-bridge par npx cadralia-bridge dans les commandes suivantes.

3. Brancher votre agent

Choisissez un seul agent pour commencer. Le connecteur local est le même pour les trois : vous pourrez changer plus tard sans réinstaller.

OpenCode

Ajoutez le plugin dans ~/.config/opencode/opencode.jsonc. Si le fichier n'existe pas, créez-le :

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": ["cadralia-bridge/opencode"]
}

Si le fichier contient déjà des réglages, ajoutez seulement plugins et la virgule qui va avec. Une virgule oubliée ou en trop empêche OpenCode de démarrer.

Redémarrez OpenCode. Le connecteur tourne dans le même processus : la livraison apparaît immédiatement dans la session ouverte.

Codex

cadralia-bridge --agent codex --project /chemin/absolu/du/projet

Remplacez /chemin/absolu/du/projet par le dossier que Codex ouvre, celui qui contient package.json. Le chemin doit être absolu : ~/projets/site ne fonctionne pas, /home/vous/projets/site fonctionne.

Laissez ce terminal ouvert pendant la session Codex.

Claude Code

cadralia-bridge install claude-code

La commande se lance une seule fois. Elle branche Cadralia à Claude Code, et le connecteur démarre tout seul au premier message. Une sauvegarde de votre configuration est créée dans ~/.claude/settings.json.cadralia-backup.

4. Créer une session

Une session n'existe qu'après un premier message. Une fenêtre ouverte et vide ne suffit pas : c'est la cause la plus fréquente du message « Aucune session » dans le panneau.

  1. Lancez votre agent dans le dossier du projet.
  2. Envoyez un message, par exemple Bonjour.
  3. Revenez dans le panneau Cadralia et cliquez sur Rafraîchir.

La session apparaît dans la liste Session cible.

5. Autoriser l'extension

  1. Le panneau détecte le connecteur et récupère le code automatiquement.
  2. Cliquez sur Autoriser. C'est la seule action à faire.
  3. Si le connecteur ne répond pas, ouvrez Saisir le code manuellement. Le code est aussi affiché dans le terminal du connecteur et dans ~/.config/cadralia/pairing-code-<port>.txt.

Le code est valable 5 minutes. Le connecteur en génère un nouveau si nécessaire.

6. Première zone

  1. Ouvrez la page qui contient la zone à reproduire.
  2. Cliquez sur l'icône Cadralia.
  3. Cliquez sur Sélectionner une zone.
  4. Glissez sur la zone, relâchez, puis cliquez sur Envoyer.
  5. Une fois l'analyse terminée, écrivez votre instruction pour l'agent si nécessaire.
  6. Vérifiez l'aperçu.
  7. Choisissez une session et cliquez sur Livrer à votre agent.

Votre agent reçoit l'image, la structure et votre instruction. Il peut travailler.

Et ensuite

  • Première zone : les limites, le clavier et l'aperçu.
  • Vérifier le rendu : comparer la page de l'agent à la référence.
  • Agir sur un détail : référencer un élément sur n'importe quelle page et donner une instruction, sans consommer d'extraction.
  • Agents : changer d'agent ou comprendre la livraison.
  • Dépannage : quand quelque chose ne répond pas.