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.
- Check that you followed the Connect your agent step of the installation.
- For OpenCode, check
cadralia-bridge/opencodein~/.config/opencode/opencode.jsonc, then restart OpenCode. - For Codex, check that the connector terminal is still open.
- For Claude Code, run
cadralia-bridge install claude-codeagain. - Click Refresh in the panel.
The connector is detected, but no session
A session only exists after a first message.
- Open your agent in the project folder.
- Send a message, for example
Hello. - Click Refresh in the panel.
Authorization does not work
- Check that the connector is running.
- Click Get the code in the panel.
- 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. - 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
- Close and restart your agent.
- Restart the connector.
- Check for an extension update in your browser, then install it.
- 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.