Aller au contenu

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

AgentComment le brancherCe qu'il faut savoir
OpenCodeajoutez le plugin cadralia-bridge/opencode, puis redémarrezla structure apparaît dans la session ouverte
Codexlancez le connecteur dans le dossier du projetgardez le terminal du connecteur ouvert
Claude Codeinstallez les hooks une foisle 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/opencode dans ~/.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.