When it doesn't work.
The fixes for the things that go wrong most. If you don't see your problem here, email phlotu@gmail.com with a description and your build number.
Sign-in keeps failing on the website.
Three usual causes: (1) the email exists with a different sign-in method — try Sign in with Google; (2) the password is wrong — use Forgot password; (3) a browser extension or strict tracking-protection setting is blocking the session cookie — try a private/incognito window. If none of those work, email phlotu@gmail.com with the email on the account and the operator will check the logs.
The Google sign-in popup closes and nothing happens.
Most often a third-party cookie / tracking protection issue. Allow tryeri.ca and accounts.google.com to set cookies, or temporarily disable strict tracking protection, then try again. On Safari, make sure "Prevent cross-site tracking" is off for tryeri.ca.
Voice / microphone isn't working.
Open System Settings → Privacy & Security → Microphone (macOS) and make sure eri is allowed. Restart the app after granting permission. If the wakeword still doesn't trigger, try Settings → Voice → Recalibrate. Bluetooth headsets sometimes drop audio quality below what the local listener needs — switching to the built-in mic is a quick test.
Eri Cloud returns no output or an error.
Three things to check: (1) your account has quota left; (2) your network can reach tryeri.ca; (3) eri is up to date — Settings → About → Check for updates, or run `eri update check`. If the error persists, paste it into a support email and the operator can help interpret.
Edits aren't applying or apply to the wrong file.
The most common cause is the editor's active file having changed since you composed the prompt. Re-open the file you intended, re-run the prompt, and review the diff before accepting. If the diff looks right but the apply step fails, check that the file isn't read-only and that it's saved with the line endings eri expects (LF on macOS/Linux, CRLF on Windows).
How do I reset the app to defaults?
Sign out, then delete the eri config directory: ~/Library/Application Support/eri (macOS), %APPDATA%\eri (Windows), or ~/.config/eri (Linux). Restart eri. Your local projects are untouched — only eri's settings and cache live there.
Where do I find logs to attach to a bug report?
Help → Reveal logs in the app menu opens the log directory. Zip the most recent log file and attach it to your email to phlotu@gmail.com, along with the eri build number (Help → About) and a description of what you were doing. The logs are local; nothing is uploaded unless you attach them.