Struct ClaudeConvo 

pub struct ClaudeConvo { /* private fields */ }

High-level interface for reading Claude conversations.

This is the primary entry point for most use cases. It provides convenient methods for reading conversations, listing projects, and accessing conversation history.

Example

use toolpath_claude::ClaudeConvo;

let manager = ClaudeConvo::new();

// List all projects
let projects = manager.list_projects()?;

// Read a conversation
let convo = manager.read_conversation(
    "/Users/alex/project",
    "session-uuid"
)?;

println!("Conversation has {} messages", convo.message_count());

Implementations

impl ClaudeConvo

pub fn new() -> Self

Creates a new ClaudeConvo manager with default path resolution.

pub fn with_resolver(resolver: PathResolver) -> Self

Creates a ClaudeConvo manager with a custom path resolver.

This is useful for testing or when working with non-standard paths.

Example

use toolpath_claude::{ClaudeConvo, PathResolver};

let resolver = PathResolver::new()
    .with_home("/custom/home")
    .with_claude_dir("/custom/.claude");

let manager = ClaudeConvo::with_resolver(resolver);

pub fn io(&self) -> &ConvoIO

Returns a reference to the underlying ConvoIO.

pub fn resolver(&self) -> &PathResolver

Returns a reference to the path resolver.

pub fn read_conversation( &self, project_path: &str, session_id: &str, ) -> Result<Conversation>

Reads a conversation by project path and session ID.

Arguments

• project_path - The project path (e.g., “/Users/alex/project”)
• session_id - The session UUID

Returns

Returns the parsed conversation or an error if the file doesn’t exist or can’t be parsed.

pub fn read_conversation_metadata( &self, project_path: &str, session_id: &str, ) -> Result<ConversationMetadata>

Reads conversation metadata without loading the full content.

This is more efficient when you only need basic information about a conversation.

pub fn list_conversations(&self, project_path: &str) -> Result<Vec<String>>

Lists all conversation session IDs for a project.

pub fn list_conversation_metadata( &self, project_path: &str, ) -> Result<Vec<ConversationMetadata>>

Lists metadata for all conversations in a project.

Results are sorted by last activity (most recent first).

pub fn list_projects(&self) -> Result<Vec<String>>

Lists all projects that have conversations.

Returns the original project paths (e.g., “/Users/alex/project”).

pub fn read_history(&self) -> Result<Vec<HistoryEntry>>

Reads the global history file.

The history file contains a record of all queries across all projects.

pub fn exists(&self) -> bool

Checks if the Claude directory exists.

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

Returns the path to the Claude directory.

pub fn conversation_exists( &self, project_path: &str, session_id: &str, ) -> Result<bool>

Checks if a specific conversation exists.

pub fn project_exists(&self, project_path: &str) -> bool

Checks if a project directory exists.

pub fn query<'a>(&self, conversation: &'a Conversation) -> ConversationQuery<'a>

Creates a query builder for a conversation.

pub fn query_history<'a>(&self, history: &'a [HistoryEntry]) -> HistoryQuery<'a>

Creates a query builder for history entries.

pub fn read_all_conversations( &self, project_path: &str, ) -> Result<Vec<Conversation>>

Reads all conversations for a project.

Returns a vector of conversations sorted by last activity.

pub fn most_recent_conversation( &self, project_path: &str, ) -> Result<Option<Conversation>>

Gets the most recent conversation for a project.

pub fn find_conversations_with_text( &self, project_path: &str, search_text: &str, ) -> Result<Vec<Conversation>>

Finds conversations that contain specific text.

Trait Implementations

impl Clone for ClaudeConvo

fn clone(&self) -> ClaudeConvo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClaudeConvo

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

Formats the value using the given formatter.

impl Default for ClaudeConvo

fn default() -> Self

Returns the “default value” for a type.