claudex 0.12.0

Reusable library for indexing and querying Claude Code, Codex, Copilot, Pi, and OpenClaw coding sessions
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

use std::path::PathBuf;

use anyhow::{Context, Result};

pub mod api;
pub mod filter;
pub mod index;
pub mod parser;
pub mod plan;
pub mod providers;
pub mod stats;
pub mod store;
pub mod time_utils;
pub mod types;

/// Returns the claudex state directory, creating it if missing.
///
/// Defaults to `~/.claudex`. Override with the `CLAUDEX_DIR` environment
/// variable — useful for sandboxed CI, read-only `$HOME`, or parallel
/// databases during development. The env var wins unconditionally when set.
pub fn claudex_dir() -> Result<PathBuf> {
    let dir = if let Some(val) = std::env::var_os("CLAUDEX_DIR")
        && !val.is_empty()
    {
        PathBuf::from(val)
    } else {
        let home = dirs::home_dir().context("could not find home directory")?;
        home.join(".claudex")
    };
    std::fs::create_dir_all(&dir).with_context(|| format!("creating {}", dir.display()))?;
    Ok(dir)
}

// Env-var override tests live in tests/cli_tests.rs — they spawn a subprocess
// with `CLAUDEX_DIR` set, which avoids racing with other lib-level tests that
// call `claudex_dir()` in the same process.