Omniscio

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:

  1. 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).
  2. 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.
  3. 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.

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