Struct Paths 

pub struct Paths {
    pub config_dir: PathBuf,
    pub data_dir: PathBuf,
    pub workspace: PathBuf,
    pub state_dir: PathBuf,
    pub cache_dir: PathBuf,
    pub runtime_dir: Option<PathBuf>,
}

Resolved directory paths for the entire application.

Created once at startup, threaded through Config. All paths are absolute.

Fields

config_dir: PathBuf

Config directory: config.toml lives here

data_dir: PathBuf

Data directory root: contains workspace/ and localgpt.device.key

workspace: PathBuf

Workspace: markdown files, knowledge, skills. May be overridden independently via LOCALGPT_WORKSPACE.

state_dir: PathBuf

State directory: sessions, audit log, logs

cache_dir: PathBuf

Cache directory: search index, embedding models

runtime_dir: Option<PathBuf>

Runtime directory: PID file, sockets. None if no suitable runtime directory is available.

Implementations

impl Paths

pub fn resolve() -> Result<Self>

Resolve all paths using real environment variables.

pub fn resolve_with_env<F>(env_fn: F) -> Result<Self>

where F: Fn(&str) -> Result<String, VarError>,

Resolve paths with a custom env var lookup (for testing).

pub fn config_file(&self) -> PathBuf

Config file: config_dir/config.toml

pub fn device_key(&self) -> PathBuf

Device key: data_dir/localgpt.device.key

pub fn audit_log(&self) -> PathBuf

Audit log: state_dir/localgpt.audit.jsonl

pub fn last_heartbeat(&self) -> PathBuf

pub fn search_index(&self, agent_id: &str) -> PathBuf

Search index for a specific agent: cache_dir/memory/{agent_id}.sqlite

pub fn sessions_dir(&self, agent_id: &str) -> PathBuf

Sessions directory for a specific agent

pub fn logs_dir(&self) -> PathBuf

Logs directory

pub fn locks_dir(&self) -> PathBuf

Locks directory (for PID and lock files)

pub fn pid_file(&self) -> PathBuf

PID file

pub fn workspace_lock(&self) -> PathBuf

Workspace lock file

pub fn pairing_file(&self) -> PathBuf

Telegram pairing file

pub fn bridge_socket_name(&self) -> String

Bridge socket name (Full path on Unix, pipe name on Windows)

pub fn managed_skills_dir(&self) -> PathBuf

Managed skills directory: data_dir/skills

pub fn embedding_cache_dir(&self) -> PathBuf

Embedding cache directory: cache_dir/embeddings

pub fn from_root(root: impl Into<PathBuf>) -> Self

Create Paths with all directories rooted under a single base path.

Mobile apps use this to point everything at their app-specific document or library directory.

pub fn ensure_dirs(&self) -> Result<()>

Create all directories with appropriate permissions.

Trait Implementations

impl Clone for Paths

fn clone(&self) -> Paths

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Paths

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

Formats the value using the given formatter.

impl Default for Paths

fn default() -> Self

Returns the “default value” for a type.