Struct JobsRoot 

pub struct JobsRoot { /* private fields */ }

Root directory of Claude Code’s on-disk background-job state. Defaults to ~/.claude/jobs; override with JobsRoot::at for tests or non-default installs.

Implementations

impl JobsRoot

pub fn home() -> Result<Self>

Resolve the default ~/.claude/jobs. Errors if the user home directory cannot be determined.

pub fn at(path: impl Into<PathBuf>) -> Self

Use a specific path as the jobs root. Useful for tests (point at a tempdir) and for non-default installs.

pub fn path(&self) -> &Path

The configured root directory.

pub fn list(&self) -> Result<Vec<JobSummary>>

List every job directory at the root, sorted by short_id.

Returns an empty vec if the root directory doesn’t exist (no background agents have been launched yet on this machine). Skips entries that aren’t directories, that don’t carry a state.json, or that fail to parse – those contribute a tracing warning so silent skips are diagnosable.

pub fn get(&self, short_id: &str) -> Result<Job>

Read one job by short id (its ~/.claude/jobs/<short_id>/ directory name). Returns the full record including the parsed timeline.jsonl. Errors if no such directory exists or state.json is missing / malformed.

Trait Implementations

impl Clone for JobsRoot

fn clone(&self) -> JobsRoot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JobsRoot

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

Formats the value using the given formatter.