Struct PathResolver 

pub struct PathResolver { /* private fields */ }

Builder-style resolver over Cursor’s data directories.

Implementations

impl PathResolver

pub fn new() -> Self

pub fn with_home<P: Into<PathBuf>>(self, home: P) -> Self

pub fn with_anysphere_dir<P: Into<PathBuf>>(self, dir: P) -> Self

Override ~/.cursor/ directly.

pub fn with_user_data_dir<P: Into<PathBuf>>(self, dir: P) -> Self

Override the Electron user-data root. On macOS this defaults to <home>/Library/Application Support/Cursor.

pub fn home_dir(&self) -> Result<&Path>

pub fn anysphere_dir(&self) -> Result<PathBuf>

Path to ~/.cursor/.

pub fn projects_dir(&self) -> Result<PathBuf>

Path to ~/.cursor/projects/.

pub fn project_transcripts_dir(&self, slug: &str) -> Result<PathBuf>

Path to the agent-transcripts folder for a project slug.

pub fn transcript_path(&self, slug: &str, composer_id: &str) -> Result<PathBuf>

Path to the JSONL transcript file for a composer in a project.

pub fn user_data_dir(&self) -> Result<PathBuf>

Path to the Electron user-data root.

pub fn user_dir(&self) -> Result<PathBuf>

Path to <user-data>/User/.

pub fn global_storage_dir(&self) -> Result<PathBuf>

Path to <user-data>/User/globalStorage/.

pub fn db_path(&self) -> Result<PathBuf>

Path to the primary cross-workspace SQLite database (<user-data>/User/globalStorage/state.vscdb).

pub fn workspace_storage_dir(&self) -> Result<PathBuf>

Path to <user-data>/User/workspaceStorage/. Cursor stores one subdirectory per workspace folder it’s been opened against, named by the workspace id (an opaque 32-hex-char hash Cursor computes from the folder URI). Each subdir contains a workspace.json with the canonical folder URI that subdir is bound to.

pub fn find_workspace_id(&self, folder: &Path) -> Result<Option<String>>

Look up Cursor’s workspace id for a given folder, if it has been opened in Cursor.app before. Scans every workspaceStorage/<id>/workspace.json, returning the <id> whose recorded folder URI canonicalizes to folder.

Returns Ok(None) when the folder hasn’t been opened yet — the caller can decide whether to synthesize one via Self::ensure_workspace_storage_entry.

pub fn ensure_workspace_storage_entry( &self, folder: &Path, synthesize_id: impl FnOnce(&Path) -> String, ) -> Result<EnsuredWorkspaceId>

Look up the workspace id for folder; if none exists, create workspaceStorage/<synthesized-id>/workspace.json recording the folder URI and return the synthesized id. The next time Cursor.app opens that folder it’ll scan workspaceStorage, match by URI, and adopt our id — so any composer we projected with workspaceIdentifier.id = <our-id> lights up in the sidebar.

synthesize_id decides what id to assign for new folders. Production callers should pass a stable hash (e.g. the first 32 hex chars of SHA-256 of the folder path) so re-runs don’t accumulate orphaned workspaceStorage entries.

pub fn exists(&self) -> bool

Whether Cursor’s user-data tree exists.

pub fn db_exists(&self) -> bool

Whether the primary global SQLite database exists.

Trait Implementations

impl Clone for PathResolver

fn clone(&self) -> PathResolver

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PathResolver

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PathResolver

fn default() -> Self

Returns the “default value” for a type.