Skip to content

Documentation

First area: select and deliver

Choose an area, understand the preview and deliver the structure to your agent.

Select

Open the page that contains the area to reproduce, click the Cadralia icon, then Select an area. Drag over the area.

Releasing the pointer sends nothing: Cadralia keeps the area and its preview on screen, with Restart and Send. A bad start no longer costs an analysis. Drag again to start over immediately, or click Restart.

While dragging, Cadralia shows the dimensions, surface and estimated weight. If the area exceeds your plan limits, it turns red: reduce the area or move to a higher plan.

With the keyboard:

  • Arrow keys: move the area.
  • Shift + arrows: resize.
  • Enter: send.
  • Escape: restart, then cancel once no area is selected.

Read the preview

The preview shows what your agent will receive:

  • the complete description of the area, as a tree;
  • the observed colors, typography, spacing and radii;
  • the detected icons;
  • the open questions;
  • a fidelity checklist: ok, partial or missing.

The implementation handoff and the states are still sent to the agent, but they are not shown in the preview.

When a category is missing, the agent knows it has to infer it. This is what prevents the "almost right" result.

Deliver

The instruction for the agent appears once the analysis is complete. It is not sent to the extraction model: it goes with the image and the structure when you deliver.

  1. Choose the target session in the panel.
  2. Check the instruction.
  3. Click Deliver to your agent.

The connector adds the image, the structure and your instruction to the session without interrupting a turn in progress. With Claude Code, if the delivery does not go out immediately, it is injected at your next message.

If the session list is empty

The connector may be connected, but no session exists yet. A session is only created after a first message.

  1. Open your agent in the project folder: opencode, codex or claude.
  2. Write a message, for example Hello, then submit it.
  3. Go back to the Cadralia panel and click Refresh.

The session then appears in Target session. An open window without a message is not enough.

If the analysis fails

The analysis can fail for a temporary reason. Your quota is then refunded and you can:

  • run the analysis again;
  • deliver the image and the instruction alone, in degraded mode.

The image is kept for at most 24 hours so you can try again.

What next

The area is only the starting point. Your agent can compare its render with the reference crop, and you can reference an element on any page without running the extraction again.

  • Check the render: your agent reads the differences in CSS pixels.
  • Act on a detail: you give a target and an instruction, without consuming an extraction.