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.
- Start your agent in the project folder.
- Send a message, for example
Hello. - Go back to the Cadralia panel and click Refresh.
The session appears in the Target session list.
5. Authorize the extension
- The panel detects the connector and fetches the code automatically.
- Click Authorize. That is the only action required.
- 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
- Open the page that contains the area to reproduce.
- Click the Cadralia icon.
- Click Select an area.
- Drag over the area, release, then click Send.
- Once the analysis is complete, write your instruction for the agent if needed.
- Check the preview.
- 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.