Browser Issues — Weavetab Docs

CDP connection failures, crashes, and extension problems.

Browser Issues

CDP connection failures, crashes, and extension problems.

# Browser Connection Issues

## "CDP connection failed" Error

**Causes:**
- Port 9222 is occupied by another process
- Chrome was launched without `--remote-debugging-port`

**Fixes:**
1. Run `weavetab reset --yes` to terminate orphaned browser processes
2. Verify port availability: `netstat -an | grep 9222`
3. Restart Weavetab

## Browser Crashes on Launch

**Fixes:**
1. Run `weavetab reset` to purge corrupted profiles
2. Check `CHROME_PATH` environment variable points to a valid Chromium executable