Skip to content

Documentation

Troubleshoot common errors

Get a working installation back, without reading the code.

Start with the Cadralia panel: it almost always shows which part is blocking.

The panel does not detect any agent

The local connector is not running, or it is not connected to your agent.

  1. Check that you followed the Connect your agent step of the installation.
  2. For OpenCode, check cadralia-bridge/opencode in ~/.config/opencode/opencode.jsonc, then restart OpenCode.
  3. For Codex, check that the connector terminal is still open.
  4. For Claude Code, run cadralia-bridge install claude-code again.
  5. Click Refresh in the panel.

The connector is detected, but no session

A session only exists after a first message.

  1. Open your agent in the project folder.
  2. Send a message, for example Hello.
  3. Click Refresh in the panel.

Authorization does not work

  1. Check that the connector is running.
  2. Click Get the code in the panel.
  3. If the field stays empty, open Enter the code manually and enter the code shown in the connector terminal or in ~/.config/cadralia/pairing-code-<port>.txt.
  4. Click Authorize.

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

If the panel says the connector is already paired with another browser, reset the pairing and start again. In a terminal:

cadralia-bridge reset

Then restart the connector and your agent, and click Authorize again.

The delivery does not go out

  • Check that a session is selected in Target session.
  • With Claude Code, the delivery may wait for your next message.
  • With Codex, keep the connector terminal open.
  • If the analysis failed, run it again or deliver in degraded mode.

Nothing changes after a refresh

  1. Close and restart your agent.
  2. Restart the connector.
  3. Check for an extension update in your browser, then install it.
  4. Reopen the Cadralia panel.

The service does not respond

Check your internet connection, then try again. If the message persists, wait a few minutes: the service may be temporarily unavailable.

Need help

If the problem persists, open an issue on the repository describing the step that is blocking and the message shown by the panel.