Documentation
Connecter OpenCode, Codex ou Claude Code
Brancher OpenCode, Codex ou Claude Code et comprendre ce qu'ils reçoivent.
Cadralia fonctionne avec OpenCode, Codex et Claude Code. Le connecteur local est le même pour les trois : il relie l'extension à votre agent, sur votre machine.
Choisir un agent
| Agent | Comment le brancher | Ce qu'il faut savoir |
|---|---|---|
| OpenCode | ajoutez le plugin cadralia-bridge/opencode, puis redémarrez | la structure apparaît dans la session ouverte |
| Codex | lancez le connecteur dans le dossier du projet | gardez le terminal du connecteur ouvert |
| Claude Code | installez les hooks une fois | le connecteur démarre tout seul au premier message |
Vous pouvez changer d'agent plus tard. Le connecteur, l'extension et votre compte ne changent pas.
OpenCode
Ajoutez le plugin dans ~/.config/opencode/opencode.jsonc :
{
"$schema": "https://opencode.ai/config.json",
"plugins": ["cadralia-bridge/opencode"]
}
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
Le connecteur lit les sessions du projet et reprend celle que vous choisissez. Le tour est ajouté à la session et l'agent travaille en arrière-plan. Gardez le terminal ouvert.
Claude Code
cadralia-bridge install claude-code
La commande se lance une seule fois. Le connecteur démarre au premier message et injecte la livraison dans la session. Si Claude Code n'est pas disponible sur le moment, la livraison attend votre prochain message.
Ce que reçoit votre agent
Votre agent reçoit cinq choses :
- la zone sélectionnée, en image ;
- la description hiérarchique complète : sections, composants, layouts, couleurs, typographie, espacements, états et questions ouvertes ;
- le handoff d'implémentation : tokens, correspondances typographiques, composants à réutiliser ou créer, règles et checklist de vérification ;
- votre instruction ;
- la référence visuelle : le crop sans perte, sa géométrie et une commande qui compare le rendu de l'agent à ce crop.
L'arbre est toujours rédigé en anglais. Le handoff, lui, suit la langue de votre instruction, avec l'anglais par défaut.
Il n'a pas besoin de deviner la mise en page. Il part de la structure réelle.
Vérifier et référencer
Deux capacités vont plus loin que la livraison, sans consommer d'extraction :
- Vérifier le rendu : votre agent compare sa page au crop de référence ;
- Agir sur un détail : vous référencez un élément ou une région sur n'importe quelle page et donnez une instruction.
Les deux sont indépendantes. Vous pouvez livrer sans jamais les utiliser.
Vos données
Le connecteur reste sur votre ordinateur. Il ne reçoit aucune clé de modèle et ne connaît pas votre compte Cadralia. Il n'accepte que les requêtes de votre navigateur.
Si ça ne marche pas
- Aucun agent détecté : vérifiez que le connecteur est lancé, puis cliquez sur Rafraîchir.
- OpenCode ne charge pas le plugin : vérifiez
cadralia-bridge/opencodedans~/.config/opencode/opencode.jsonc, puis redémarrez OpenCode. - Aucune session : envoyez un premier message dans l'agent. Une fenêtre vide ne crée pas de session.
- Livraison en attente avec Claude Code : elle partira à votre prochain message.
- Le panneau ne répond plus : relancez le connecteur, puis rafraîchissez le panneau.
Besoin de plus de détails ? Voir Dépannage.