Skip to content

Documentation

Install Cadralia in Brave or Chrome

Install the extension, connect your agent and deliver your first structure.

Cadralia installs in three steps: the extension, the local connector, then connecting your agent. Allow ten minutes.

The site, the extension and API messages follow your browser language. Use the FR / EN switch in the header to change it.

Before you start

  • Brave or Chrome.
  • Node.js 20 or later. Check with node --version.
  • OpenCode, Codex or Claude Code installed and working.
  • A Cadralia account. The Free plan is free and does not require a card.

1. Install the extension

Install Cadralia from the Chrome Web Store. The icon appears in the toolbar: a click opens the side panel.

If you use a build distributed outside the store, load the latest release archive in brave://extensions or chrome://extensions with Load unpacked.

2. Install the connector

In a terminal:

npm install -g cadralia-bridge

Without a global install, replace cadralia-bridge with npx cadralia-bridge in the following commands.

3. Connect your agent

Choose one agent to start. The local connector is the same for all three: you can change later without reinstalling.

OpenCode

Add the plugin to ~/.config/opencode/opencode.jsonc. If the file does not exist, create it:

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

If the file already contains settings, add only plugins and the comma that goes with it. A missing or extra comma prevents OpenCode from starting.

Restart OpenCode. The connector runs in the same process: the delivery appears immediately in the open session.

Codex

cadralia-bridge --agent codex --project /absolute/path/to/project

Replace /absolute/path/to/project with the folder Codex opens, the one that contains package.json. The path must be absolute: ~/projects/site does not work, /home/you/projects/site does.

Keep this terminal open during the Codex session.

Claude Code

cadralia-bridge install claude-code

The command runs once. It connects Cadralia to Claude Code, and the connector starts on its own at the first message. A backup of your configuration is created in ~/.claude/settings.json.cadralia-backup.

4. Create a session

A session only exists after a first message. An open, empty window is not enough: this is the most common cause of the "No session" message in the panel.

  1. Start your agent in the project folder.
  2. Send a message, for example Hello.
  3. Go back to the Cadralia panel and click Refresh.

The session appears in the Target session list.

5. Authorize the extension

  1. The panel detects the connector and fetches the code automatically.
  2. Click Authorize. That is the only action required.
  3. If the connector does not answer, open Enter the code manually. The code is also shown in the connector terminal and in ~/.config/cadralia/pairing-code-<port>.txt.

The code is valid for 5 minutes. The connector generates a new one when needed.

6. First selection

  1. Open the page that contains the area to reproduce.
  2. Click the Cadralia icon.
  3. Click Select an area.
  4. Drag over the area, release, then click Send.
  5. Once the analysis is complete, write your instruction for the agent if needed.
  6. Check the preview.
  7. Choose a session and click Deliver to your agent.

Your agent receives the image, the structure and your instruction. It can get to work.

What next

  • First area: the limits, the keyboard and the preview.
  • Check the render: compare the agent page with the reference.
  • Act on a detail: reference an element on any page and give an instruction, without consuming an extraction.
  • Agents: change agent or understand the delivery.
  • Troubleshooting: when something does not respond.