Struct ClaudeHistoryAdapter 

pub struct ClaudeHistoryAdapter {
    user_home: Option<PathBuf>,
    shared_dir: Option<PathBuf>,
    agentmux_home: Option<PathBuf>,
}

Where Claude homes live. The homes under them — one per account, and channels — are listed again on every discovery (ClaudeHistoryAdapter::base_dirs), because they are created while srv runs: an account added or switched after srv started used to stay invisible until the next restart.

Fields

user_home: Option<PathBuf>

The user’s home: ~/.claude and ~/.config/claude-*.

shared_dir: Option<PathBuf>

<shared>: providers/claude and identities/*.

agentmux_home: Option<PathBuf>

AgentMux’s home: channels/*/identities/* and dev/…/identities/*.

Implementations

impl ClaudeHistoryAdapter

fn push_deduped_dir( dirs: &mut Vec<PathBuf>, seen: &mut HashSet<PathBuf>, path: PathBuf, )

Push path onto dirs iff it’s a real directory AND its canonical (symlink/junction-resolved) form hasn’t already been pushed — the dedup key, not path itself, since two different base_dirs entries can be different paths to the same physical directory (a per-channel isolated projects/ junction and the global location it points at). Falls back to the literal path when canonicalization fails (e.g. a dangling/broken link) rather than silently dropping it.

pub fn new() -> Self

pub(crate) fn with_roots( user_home: Option<PathBuf>, shared_dir: Option<PathBuf>, agentmux_home: Option<PathBuf>, ) -> Self

fn base_dirs(&self, problems: &mut Vec<String>) -> Vec<PathBuf>

Every Claude projects/ directory under the roots, as the filesystem stands now. Deduplicated by canonical (symlink/junction-resolved) path: after Step 3 above, a per-channel isolated projects/ dir may be a junction pointing at the exact same physical location as one of the global <shared>/... entries, and scanning both would surface every session twice.

fn scan_isolated_identities_under( root: &Path, base_dirs: &mut Vec<PathBuf>, seen: &mut HashSet<PathBuf>, max_depth: u8, problems: &mut Vec<String>, )

Find every identities/ directory up to max_depth levels under root, and for each, every <account_id>/claude/projects that exists. Bounded, not an unbounded recursive walk — channel/dev directory layouts are shallow by construction (channels/<slug>/identities/, dev/<branch>/identities/ or dev/<branch>/<clone_id>/identities/), so depth 2 covers every known layout without risking an expensive filesystem walk if something unexpected is nested underneath.

fn count_subagents(session_dir: &Path) -> u32

Count subagent JSONL files in a session’s subagents/ directory.

fn decode_project_path(encoded: &str) -> String

Decode a project directory name back to a path. e.g., “C–Users-user–claw-agentx-workspace” → “C:/Users/user/.claw/agentx-workspace” This is lossy — real hyphens are indistinguishable from path separators.

fn identity_id_from_path(path: &Path) -> String

Parse the account id a session’s absolute file path was discovered under, if any: .../identities/<account_id>/claude/... (both the always-global <shared>/identities/... location and the per-channel isolated <home>/channels/*/identities/... / <home>/dev/*/(*/)?identities/... locations share this same identities/<account_id>/claude/ shape — see new()’s scan roots). Empty string for any other base_dir (personal ~/.claude, the default <shared>/providers/claude/projects, legacy ~/.config/claude-*) — those have no account to attribute to.

Trait Implementations

impl HistoryAdapter for ClaudeHistoryAdapter

fn provider(&self) -> &str

Provider identifier (e.g., “claude”, “codex”, “gemini”, “kimi”, “openclaw”, “pi”).

fn discover_files(&self) -> Result<Vec<DiscoveredFile>, HistoryError>

Discover all session file paths on disk. Returns (file_path, mtime_ms) pairs, sorted by mtime descending.

fn discover(&self) -> Result<Discovery, HistoryError>

Self::discover_files, plus what the walk couldn’t read. An adapter whose discovery can’t fail part-way keeps this default.

fn extract_meta( &self, file_path: &str, ) -> Result<Option<SessionMeta>, HistoryError>

Extract lightweight metadata without full parsing.

fn parse_file( &self, file_path: &str, ) -> Result<Option<HistorySession>, HistoryError>

Parse a single session file into a full HistorySession.