Chat won't load or respond

When the chat is dead, the cause is almost always one of: network, browser, ad-blocker, or a Ritsu service incident. Run this checklist in order.

90-second triage

1. Hard refresh

Cmd+Shift+R (Mac) / Ctrl+Shift+F5 (Windows). Bypasses the cache. Fixes about 30% of "chat won't load" reports.

2. Check status

Visit https://status.ritsu.ai. If we're down, you're not alone — sit tight or follow the incident updates.

3. Try a different network

Switch from Wi-Fi to cellular tether (or vice versa). Corporate / school networks sometimes block streaming endpoints, which kills chat responses mid-stream.

4. Disable ad-blockers + privacy extensions

uBlock Origin, Privacy Badger, Brave Shields — they sometimes block our streaming endpoint. Whitelist ritsu.ai and reload.

5. Try incognito / private window

Bypasses extensions and clears caches. If the chat works in incognito, an extension is the culprit.

6. Check browser

We support latest Chrome, Firefox, Safari, Edge (within last 6 months). Old browsers may not support our streaming protocol.

Specific symptoms

"Loading…" forever

Usually a streaming connection that didn't open. Refresh. If it still hangs, your network is blocking Server-Sent Events. Try a different network.

Chat opens but commands don't respond

Type /help. If /help works (returns the command list) but /explain doesn't, the issue is server-side or model-specific. Check status, try /explain again in 30 seconds. If /help doesn't work either, the chat connection itself is broken — refresh.

Response starts streaming, then cuts off mid-sentence

Network blip — your connection dropped during the stream. The response is saved partially. Run the command again to regenerate.

"Something went wrong" toast appears

Tap Details in the toast for the error code. Common codes:

• RATE_LIMITED — Free plan quota hit. Wait or upgrade.
• MODEL_OVERLOADED — provider issue. Retry in a minute.
• CONTEXT_TOO_LARGE — your PoK / source content exceeds the model context. Split into smaller PoKs.
• INTERNAL_ERROR — our bug. Email support@ritsu.ai with the code, we'll investigate.

Browser-specific gotchas

• Safari — disabling Prevent cross-site tracking in Safari → Privacy fixes some auth-related chat issues
• Firefox — Enhanced Tracking Protection on Strict can block our streaming. Switch to Standard for ritsu.ai.
• Chrome on a managed device (school / work) — IT policy may block extensions or domains. Try cellular.

Still broken?

Email support@ritsu.ai with:

• Browser + OS version
• The exact command you ran
• Time of day (timezone)
• Screenshot of the error if any

We respond within 24 hours, usually within 4.