---
title: Data folder recovery (your data looks gone after an update)
---

# Data folder recovery (your data looks gone after an update)

## What it is

Omniscio keeps everything — sessions, projects, hubs, plugins, automations, settings — in one
**data folder** on your computer. When the app's folder name changes (it changed from
`agent-mission-control` to `omniscio` in the 0.1.103 update), the first launch of the new version
moves your existing folder onto the new name so nothing is lost.

If it cannot do that safely, Omniscio now **asks you** instead of quietly starting an empty profile.

## Where to find it

The folder itself is not something the app shows you a button for unless you go looking: **Settings → System → Data Folder** prints the exact path and has an **Open Data Folder** button that takes you straight there in your file browser. When the move needs your input it comes to you instead — a dialog on launch, or a notice in your inbox if a sign-in ever stops being confirmable.

### Where the folder lives

- **macOS**: `~/Library/Application Support/omniscio`
- **Windows**: `%APPDATA%\omniscio`
- **Linux**: `~/.config/omniscio`

Settings → System → **Data Folder** shows the exact path and has an **Open Data Folder** button.

## How it behaves

### How the move decides

On launch, before anything else opens, Omniscio checks whether a folder with the previous name
still holds a database:

- **The new folder does not exist yet** → your old folder is renamed to the new name. Done.
- **The new folder exists but was never really used** — it holds no database, or a small database
  (under 5 MB) with zero sessions that no running copy of Omniscio owns (a leftover from a crashed
  first start or a developer run) → that leftover is set aside as a timestamped sibling (nothing is
  deleted) and your old folder is moved into place. A database that reports zero sessions but is
  larger than that, or whose size cannot be read, is treated as real data and never moved.
- **Both folders hold real data** → Omniscio shows a dialog: **"Your previous Omniscio data was
  found"**, naming both folders.
  - **Use my previous data and restart** — the app restarts, sets the current folder aside
    (kept, not deleted) and moves your previous data into place. You are back where you were.
  - **Keep this profile** — the app continues with the current folder and remembers your choice,
    so it does not ask again.

### If you already see an empty app

Do **not** use "Restore from backup" for this — that list only shows backups of the profile you are
currently in (the empty one). Quit Omniscio, then in the data-folder location above rename the
current `omniscio` folder to something like `omniscio.old`, rename your previous folder
(`agent-mission-control`) to `omniscio`, and start the app. Your previous folder still has its own
`backups/` inside it.

### Saved sign-ins after the move (Mac)

On a Mac, the key that protects your saved sign-ins — your accounts, connected services and the
Google sign-in setup — lives in your login Keychain under the app's **old** name. Right after the
move, Omniscio checks whether it can still open them. If it cannot, it asks **"Restore your saved
sign-ins?"** before anything else loads: choose **Restore and restart**, allow the macOS
permission prompt (sometimes two), and Omniscio restarts with everything readable again. The key
it replaces is kept in your Keychain under `omniscio Safe Storage (before restore …)`, so nothing
is lost. Choosing **Not now** means signing in to each account again, and the question is not
asked again once you have answered (a copy that fails is retried on the next start, at most three
times). Windows is not affected.

**If your sign-in broke and you did not notice.** A half-restored sign-in is the awkward case: your account id is stored in plain text, so Omniscio keeps showing you as signed in, while the saved credential it needs to *confirm* your account is gone. After a week of not being able to confirm it, anything tied to your plan quietly starts behaving as if you were on the free plan — higher limits, cloud features, and publishing a share without the "Made with Omniscio" badge. Omniscio now tells you instead of going quiet: you get one inbox notice, **"Omniscio can’t confirm your account"**, with a button that takes you to Accounts to sign in again. It appears as soon as the app checks (on launch or reconnect), not hours later; it repeats at most once a day rather than every few hours; and it clears itself the moment your account is confirmed again. **You are never signed out or locked out by it** — if you are simply offline, nothing changes and no notice appears.

If you skipped it and want it back later: quit Omniscio, open **Keychain Access**, copy the
password of the `agent-mission-control Safe Storage` item into the `omniscio Safe Storage` item
(create it if it is missing), delete the file `keyring-migration.json` inside the data folder, and
start the app. If Omniscio still reports that it cannot read your sign-ins after a restore, the
key it copied was not the right one — the same manual copy fixes it.

## Related

If you did end up on a new, empty profile and want to check what the app decided and when, the [startup trace](startup-trace.md) records which folder was chosen on each launch. The ordinary backup and restore surface — which is a different thing from this folder move, and will not help with it — is on the [automatic backups and restore](setup-backup.md) page. A sign-in that stopped being confirmable, and what the app now does about it, is covered on [Plan & Usage](plan-billing.md).

- [Startup trace](startup-trace.md) — the launch log that records which folder was chosen
  (`[Startup] dataDir=…`) and any `SPLIT DATA DIR DETECTED` line.
- [Automatic backups and restore](setup-backup.md)