From bc31ad7dba3e69978dd4630f3156aa62a085471c Mon Sep 17 00:00:00 2001 From: AMATH <116212274+amathxbt@users.noreply.github.com> Date: Fri, 30 Jan 2026 17:43:37 +0100 Subject: [PATCH 1/2] Enhance README with troubleshooting guidelines Added troubleshooting section for Windows installation and dependency conflicts. --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 3dd6652..5143d4e 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,19 @@ The documentation will be available at `http://localhost:3000`. - If the dev environment isn't running - Run `npm install` to re-install dependencies. ## Contributing +### Troubleshooting + +#### Windows Installation +If you are on Windows and encounter errors installing dependencies, we recommend using **WSL (Windows Subsystem for Linux)**. +1. Run `wsl --install` in PowerShell. +2. Restart and install the requirements within the WSL terminal. + +#### Dependency Conflicts +If `npm install` fails, try clearing your cache: +```bash +npm cache clean --force +rm -rf node_modules +npm install When contributing to the documentation: From 07f7eb83ee289bb738b3a808ce4c28ca4f8bca3b Mon Sep 17 00:00:00 2001 From: AMATH <116212274+amathxbt@users.noreply.github.com> Date: Fri, 30 Jan 2026 18:12:21 +0100 Subject: [PATCH 2/2] Update README with authentication loop instructions Added troubleshooting steps for authentication loops. --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index 5143d4e..b2e5e5e 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,12 @@ If `npm install` fails, try clearing your cache: npm cache clean --force rm -rf node_modules npm install +#### Authentication Loops (401 Unauthorized) +If you are repeatedly asked to log in or see 401 errors: +1. Clear browser cookies for `memsync.ai`. +2. Ensure the extension has permissions for your specific AI site (ChatGPT, Claude, etc.). +3. Log out and back in via the MemSync dashboard to refresh your session. + When contributing to the documentation: