claude-wrapper 0.12.2

A type-safe Claude Code CLI wrapper for Rust
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

//! Inspect Claude Code's on-disk state without spawning the CLI.
//!
//! The read-side introspection modules parse `~/.claude` directly:
//! session history, skills, agents, and merged settings. None of this
//! launches the `claude` binary, so it is cheap and safe to run in a
//! read-only context. Every accessor degrades to an empty result when
//! the underlying directory does not exist, so this runs fine on a
//! machine that has never used Claude Code.
//!
//! ```sh
//! cargo run --example inspect_state --features json
//! ```

use claude_wrapper::artifacts::AgentsRoot;
use claude_wrapper::history::HistoryRoot;
use claude_wrapper::settings::{SettingsLayer, SettingsLoader};
use claude_wrapper::skills::SkillsRoot;

fn main() -> claude_wrapper::Result<()> {
    // --- Session history -------------------------------------------------
    // Stored as line-delimited JSON under
    // `~/.claude/projects/<slug>/<session_id>.jsonl`.
    let history = HistoryRoot::home()?;
    let projects = history.list_projects()?;
    println!("projects with history: {}", projects.len());

    if let Some(project) = projects.first() {
        println!(
            "  {} ({} session(s))",
            project.decoded_path.display(),
            project.session_count
        );

        let sessions = history.list_sessions(Some(&project.slug))?;
        if let Some(session) = sessions.first() {
            println!(
                "  session {} -- {} message(s)",
                session.session_id, session.message_count
            );

            // Read and parse the full session log.
            let log = history.read_session(&session.session_id)?;
            println!("  entries in log: {}", log.entries.len());
        }
    }

    // --- Skills (`~/.claude/skills/<name>/SKILL.md`) ---------------------
    println!();
    for skill in SkillsRoot::home()?.list()? {
        println!(
            "skill: {} -- {}",
            skill.name,
            skill.description.as_deref().unwrap_or("(no description)")
        );
    }

    // --- Agents (`~/.claude/agents/<name>.md`) ---------------------------
    for agent in AgentsRoot::home()?.list()? {
        println!(
            "agent: {} (model: {})",
            agent.name,
            agent.model.as_deref().unwrap_or("default")
        );
    }

    // --- Settings, merged across the four precedence layers --------------
    let settings = SettingsLoader::home()?.load()?;
    let present = SettingsLayer::all()
        .into_iter()
        .filter(|&layer| settings.get(layer).is_some())
        .count();
    println!("\nsettings layers present: {present}/4");

    Ok(())
}