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 for the backup locations and restore steps.