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.
- Lancez votre agent dans le dossier du projet.
- Envoyez un message, par exemple
Bonjour. - Revenez dans le panneau Cadralia et cliquez sur Rafraîchir.
La session apparaît dans la liste Session cible.
5. Autoriser l'extension
- Le panneau détecte le connecteur et récupère le code automatiquement.
- Cliquez sur Autoriser. C'est la seule action à faire.
- 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
- Ouvrez la page qui contient la zone à reproduire.
- Cliquez sur l'icône Cadralia.
- Cliquez sur Sélectionner une zone.
- Glissez sur la zone, relâchez, puis cliquez sur Envoyer.
- Une fois l'analyse terminée, écrivez votre instruction pour l'agent si nécessaire.
- Vérifiez l'aperçu.
- 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.