# Session and Window State Storage

Where Nimbalyst stores AI session history and window state on your machine, including the local database location on macOS, Windows, and Linux.

Session history and window state are stored in a local database on your own machine. This page covers which database that is, where it lives, and what a session record contains.

### The database

**Backend:** SQLite on newer installs. Installs that predate the SQLite migration stay on PGLite until they migrate.

**Tables:** `ai_sessions` for the sessions themselves, `ai_agent_messages` for the message log behind each one.

**Location:** inside the Nimbalyst application data folder.

| Platform | Application data folder |
| -------- | ----------------------- |
| macOS | `~/Library/Application Support/Nimbalyst` |
| Windows | `%APPDATA%\Nimbalyst` |
| Linux | `~/.config/Nimbalyst` |

Development builds use an `@nimbalyst/electron` folder in the same platform-specific location.

The database itself is `sqlite-db/nimbalyst.sqlite` on SQLite, or the `pglite-db/` folder on PGLite.

### What a session record holds

* Session id, title, and workspace
* Provider and model
* Session type, mode, and agent role
* Document context and the last document state
* Draft input you typed but have not sent
* Parent, branch, and worktree links
* Status, pinned and archived flags, and created and updated timestamps

Conversation messages are stored separately in `ai_agent_messages` and linked back to the session id, so a long transcript does not have to be rewritten every time the session changes.

### Backups

Nimbalyst backs this database up every 12 hours by default and on quit, keeping two rolling copies by default. You can change the interval and keep one to three copies under **Settings > Application > Database**. See [Database Backups and Restore](https://nimbalyst.com/docs/troubleshooting/database-backups-and-restore/) for the backup locations and restore steps.