Troubleshooting

Common Issues

"Extension not connected"

• Ensure the opencli Browser Bridge extension is installed and enabled in chrome://extensions.
• Run opencli doctor to diagnose connectivity.

Empty data or 'Unauthorized' error

• Your login session in Chrome might have expired. Open a normal Chrome tab, navigate to the target site, and log in or refresh the page.
• Some sites have geographic restrictions (e.g., Bilibili, Zhihu from outside China).

Node API errors

• Make sure you are using Node.js >= 20. Some dependencies require modern Node APIs.
• Run node --version to verify.

Daemon issues

# Check daemon status
curl localhost:19825/status

# View extension logs
curl localhost:19825/logs

# Kill and restart daemon
pkill -f opencli-daemon
opencli doctor

Desktop adapter connection issues

For Electron/CDP-based adapters (Cursor, Codex, etc.):

1. Make sure the app is launched with --remote-debugging-port=XXXX
2. Verify the endpoint is set: echo $OPENCLI_CDP_ENDPOINT
3. Test the endpoint: curl http://127.0.0.1:XXXX/json/version

Build errors

# Clean rebuild
rm -rf dist/
npm run build

# Type check
npx tsc --noEmit

Getting Help

• GitHub Issues — Bug reports and feature requests
• Run opencli doctor --live for comprehensive diagnostics