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 wakeword model needs — switching to the built-in mic is a quick test.
The model returns no output or an error.
Three things to check: (1) your BYOK API key is valid and has credit/quota left on the provider side; (2) your network can reach the provider endpoint (corporate proxies often block them); (3) eri is up to date — Settings → About → Check for updates. If the model returns an error, the message usually comes from the provider; 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.