Something's not working? Start here
The front door for when Omniscio is misbehaving. Find the line that matches what you're actually seeing, and follow it. Every destination is a real page with the full fix — this page only points.
On this page
What it is
The front door for when Omniscio is misbehaving. Find the line that matches what you're actually seeing, and follow it. Every destination is a real page with the full fix — this page only points.
You don't need to know what caused it. Describe the symptom to yourself in plain words and pick the closest match.
If you have the exact words of an error message, skip the symptom hunt: Error messages explained quotes the common ones verbatim and says what each means.
In a hurry, or not sure which line fits? Open any session and say: "Something's wrong with Omniscio — here's what I'm seeing: …" Your agent can read the diagnostics and work it out with you. That is always a valid first move.
Where to find it
This page is the entry point — it is a list of symptoms. Read down it, find the line that matches what you are seeing, and follow it to the page carrying the fix.
How it behaves
The app itself
| What you're seeing | Go to |
|---|---|
| It won't open. You click the icon, maybe more than once, and nothing appears — or it says it's already running | App already running, or frozen |
| The window went blank/white. The frame is still there — minimise and close still work — but the sidebar and chat are gone | Blank-screen recovery button |
| Everything is slow, hitching, or freezing. Fans spinning, the whole computer feels heavy | Computer feels slow? |
| My sessions vanished after a crash, a restart, or a Windows update | Crash recovery — they come back on their own; this explains what to expect |
| It's behaving strangely and I want to isolate it. You want everything automatic turned off so you can test by hand | Safe Mode |
| A Mac permission was denied, or recordings come out black or silent | macOS permissions — each prompt and its System Settings path; a Screen Recording grant only applies after you quit and reopen Omniscio |
A session is stuck
Four different stucks that look similar but have different fixes. Match the detail, not the vibe.
| What you're seeing | Go to |
|---|---|
| An amber dot / "Needs You" on the session, and it won't move until you do something | Session stuck in Needs You — the sub-label (Question · Permission · Rate Limited · Auth Error · Stopped) tells you which fix |
| The spinner says "thinking" forever and nothing ever arrives | Auto-restart stuck sessions — Omniscio usually catches this itself within a few minutes |
| It stopped part-way through a reply and there's nothing after the last message | Context stall recovery — Omniscio nudges it to continue, then sends it to your inbox if that fails |
| A reply just disappeared — the session went silent mid-answer | Aborted response recovery — it retries quietly; a Retry pill appears if you want to force it |
Not sure which? Start with the first row. The "Needs You" page is the one that covers the most cases, and it tells you how to read the sub-label.
Connection, sign-in, and scheduled work
| What you're seeing | Go to |
|---|---|
| An amber "You're offline" banner, and sessions have stopped making progress | Offline banner — they pause and resume on their own when your connection returns |
| Your browser works but Omniscio can't reach anything — every session and AI helper fails with a network error, and no offline banner appears | Network and proxy — the app needs direct outbound access, so a work laptop's proxy or a company firewall can break it while everything else on the machine is fine |
| Sign-in trouble with a Claude account, or you're not sure which sign-in method a session is using | Auth pathways |
| A scheduled job failed and you want to know why, or stop it nagging | Cron failure alerts |
| A cloud session won't start at all | When a cloud session won't start |
| A session started but produced no output — "timed out … no output after N seconds" | Session started but produced no output |
| An agent can't get into a website it needs to be logged into | Browser logins |
Setting up, accounts, and plans
| What you're seeing | Go to |
|---|---|
| It's a new install, or first-run setup never finished | First-time setup |
| A setup step said "This step hit a snag", or "Repair Needed" appeared | First-time setup — and Error messages explained for the exact words |
| "Claude Code isn't installed (or can't be found)" | Error messages explained → install it from Settings → Connected Tools |
| Signing in to Omniscio fails, or an account is disabled / rate-limited | Error messages explained → sign-in section |
| A Claude account is signed out or capped, or you want to add another | Auth pathways · Multiple Claude accounts · Sign back in to Claude when you are logged out |
| A provider key or balance is the problem (DeepSeek, GLM, Kimi, …) | API Keys · Provider routing |
| A plan limit, credit, or checkout problem | Plan & Usage · Error messages explained → billing |
Data, backups, and sync
| What you're seeing | Go to |
|---|---|
| My data looks gone after an update, or the app says it can't open its database | Data folder recovery |
| I want to know whether my data is encrypted, or where it lives | Is my data encrypted? · Database Encryption |
| I want backups — set one up, or check one is working | Backup Mirror · Local and cloud backups · Export / import all data |
| My changes aren't reaching my other devices | Cross-Device Sync |
| A card says "The database is busy right now" or "Cross-Device Sync is failing" | Error messages explained → data section |
Integrations and automations
| What you're seeing | Go to |
|---|---|
| Google (Gmail, Calendar, Drive, Sheets) is disconnected or won't connect | Google Integrations |
| A project board (Linear, ClickUp, Asana, Notion) isn't syncing | Linear · ClickUp · Asana · Notion |
| Email or a messaging channel (Gmail, SMS, Slack, Telegram) is down | Agent Email · Slack · Telegram · Set up SMS |
| Team Chat is offline, its background sync is degraded, or it says new messages may not appear | Team Chat part 4 → When something goes wrong — the Reconnect warning, send failures, and what each message means |
| Voice, dictation, or the wake word isn't working | Voice, TTS & Wake Word |
| An automation isn't doing what it should, or a card says an action failed | Automations & Auto-replies · Error messages explained → integrations |
Updating, diagnosing, and reporting
| What you're seeing | Go to |
|---|---|
| An update is waiting, or the app says "Update Needed" | App Update Notifications |
| Something is odd and I want a real diagnosis before asking anyone | Resources diagnostic panel · Logs and debugging |
| The app is running out of memory ("Low on working memory") | Computer feels slow? — what uses memory, what to close, and why a restart clears it |
| I want to report a bug with the diagnostic detail attached | The toolbar Feedback button — Report conversations. For the detail, Settings → Diagnostics → Export diagnostic bundle (Logs and debugging) |
| An alert, toast or banner I expected never appeared — a session finished, a job failed, or someone replied, and nothing interrupted me | First check Notification History — it lists every toast and dismissed alert, so a notification that fired and was swept away still shows there. If it isn't listed, the interrupt settings are the cause: Notifications & Silence covers Quiet Hours, per-type toggles and the OS-level prompt. If you're on a phone or another device, Mobile web push covers the pairing that has to be in place. When both check out and it still never arrives, describe it to an agent in any session — it can read the alert log and tell you whether the row was raised at all |
Nothing above matches
First, try Error messages explained — if the app showed you a sentence, that page is indexed by the sentence itself.
A few more things worth trying before anything drastic:
- Restart Omniscio. Settings apply live, but anything that got into a bad state usually clears on a restart. It's free and it costs you nothing but a few seconds — your sessions come back on their own (Crash recovery explains how).
- Ask an agent. Open any session and describe what you're seeing in your own words. It can read the app's own diagnostics, which you can't see from the outside, and it will tell you what it finds.
- Still stuck? Email support@omniscio.com. Include the exact message you saw and roughly when it happened. If the app opens at all, open Settings → Diagnostics, click Export diagnostic bundle, and attach the ZIP it saves to your Downloads folder. Inside a working app you can send it with the toolbar Feedback button — Report conversations explains what happens next.
For developers
Two recovery surfaces here are not for everyday use — they need the local control server and a bearer token:
- CLI session recovery — force-restart a dead session process, move it to another account, or nudge an idle one, over HTTP.
- Heap snapshot diagnostics — get a JSON summary of where Omniscio's memory has gone, without opening DevTools.
Related
See also
- Computer feels slow? — the performance checklist this page hands off to, and the deepest troubleshooting page in the library.
- Safe Mode — the "turn everything off and see if it still happens" escape hatch.
Last verified 2026-11-10