Cursor IDE¶

The Cursor desktop application, modelled as its own backend (cursor-ide) separate from the terminal CLI. It stores chat history in VS Code-style state.vscdb SQLite databases under the platform user-data directory.

Stores¶

cursor-ide.state_vscdb

Role:: primary_chat
Format:: sqlite
Coverage:: default_search
Adapter:: cursor_ide.state_vscdb_modern.v1cursor_ide.state_vscdb_legacy.v1

cursor-ide.workspace_state

Role:: primary_chat
Format:: sqlite
Coverage:: default_search
Adapter:: cursor_ide.state_vscdb_modern.v1

`cursor-ide.state_vscdb`¶

cursor-ide.state_vscdb

Cursor IDE chat storage; keys in ItemTable/cursorDiskKV containing chat/composer/prompt/history tokens hold conversation JSON. Cursor does not publish a formal schema — agentgrep’s parser is the reference implementation.

Agent:: Cursor IDE
Role:: primary_chat
Format:: sqlite
Coverage:: default_search
Path:: ${HOME}/.config/Cursor/User/globalStorage/state.vscdb
Adapter:: cursor_ide.state_vscdb_modern.v1, cursor_ide.state_vscdb_legacy.v1
Data version:: -
Version strategies:: -
Observed:: Cursor IDE (current observed paths) (2026-05-17)
Default search:: yes

Cursor IDE store, parsed by the current cursor_ide.state_vscdb_modern.v1 adapter. Not the same as the Cursor CLI agent transcripts.

`cursor-ide.workspace_state`¶

cursor-ide.workspace_state

Per-workspace state.vscdb, one per opened project under workspaceStorage/<hash>/. Same ItemTable shape as the global store; the aiService.prompts key holds that workspace’s prompt history. Reuses the cursor_ide.state_vscdb_modern.v1 adapter.

Agent:: Cursor IDE
Role:: primary_chat
Format:: sqlite
Coverage:: default_search
Path:: ${HOME}/.config/Cursor/User/workspaceStorage/<hash>/state.vscdb
Adapter:: cursor_ide.state_vscdb_modern.v1
Data version:: -
Version strategies:: -
Observed:: Cursor IDE (current observed paths) (2026-05-30)
Default search:: yes

Per-workspace IDE history, complementing the global cursor-ide.state_vscdb. Parsed by the shared cursor_ide.state_vscdb_modern.v1 adapter.

Record schemas¶

cursor-ide.state_vscdb¶

Platform-specific SQLite (state.vscdb). Keys in ItemTable/cursorDiskKV containing chat/composer/prompt/ history tokens hold conversation JSON.

Platform	Path
Linux	`~/.config/Cursor/User/globalStorage/state.vscdb`
macOS	`~/Library/Application Support/Cursor/User/globalStorage/state.vscdb`
Windows	`%APPDATA%/Cursor/User/globalStorage/state.vscdb`

cursor-ide.workspace_state¶

The IDE also writes one state.vscdb per opened project under workspaceStorage/<hash>/. These share the global store’s ItemTable shape; the aiService.prompts key holds that workspace’s typed prompt history. agentgrep enumerates them through the platform workspaceStorage directory and parses them with the same adapter as the global store.