claude-dashboard 0.2.2

A terminal TUI dashboard that renders Claude Code usage reports with token stats, project breakdowns, and language distribution.
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

mod cache;
mod client;
mod config;
mod prompt;

pub use cache::{cache_dir, delete_cache, read_cache, write_cache};
pub use client::call_haiku_api;
pub use config::{load_api_config, LlmApiConfig};
pub use prompt::build_prompt;

use std::fs;
use std::path::Path;
use std::time::UNIX_EPOCH;

// ── Report type ──────────────────────────────────────────

#[derive(Debug, Clone, Copy, PartialEq)]
pub enum LlmReportType {
    All,
    Monthly,
    Yearly,
}

// ── Source file mtime ────────────────────────────────────

/// Compute the maximum modification timestamp (Unix seconds) across all
/// source data files that could affect report content.
pub fn compute_source_mtime(claude_dir: &Path) -> u64 {
    let mut max_mtime: u64 = 0;

    let mut check = |path: &Path| {
        if let Ok(meta) = fs::metadata(path) {
            if let Ok(modified) = meta.modified() {
                if let Ok(dur) = modified.duration_since(UNIX_EPOCH) {
                    max_mtime = max_mtime.max(dur.as_secs());
                }
            }
        }
    };

    check(&claude_dir.join("stats-cache.json"));
    check(&claude_dir.join("history.jsonl"));

    let projects_dir = claude_dir.join("projects");
    if let Ok(entries) = fs::read_dir(&projects_dir) {
        for entry in entries.flatten() {
            let proj_path = entry.path();
            if !proj_path.is_dir() {
                continue;
            }
            if let Ok(sessions) = fs::read_dir(&proj_path) {
                for s in sessions.flatten() {
                    let sp = s.path();
                    if sp.extension().map(|e| e == "jsonl").unwrap_or(false) {
                        check(&sp);
                    }
                }
            }
        }
    }

    max_mtime
}

// ── Tests ────────────────────────────────────────────────

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_llm_report_type_equality() {
        assert_eq!(LlmReportType::All, LlmReportType::All);
        assert_eq!(LlmReportType::Monthly, LlmReportType::Monthly);
        assert_eq!(LlmReportType::Yearly, LlmReportType::Yearly);
        assert_ne!(LlmReportType::All, LlmReportType::Monthly);
        assert_ne!(LlmReportType::Monthly, LlmReportType::Yearly);
    }

    #[test]
    fn test_compute_source_mtime_no_files() {
        let mtime = compute_source_mtime(Path::new("/nonexistent/path"));
        assert_eq!(mtime, 0);
    }

    #[test]
    fn test_compute_source_mtime_real() {
        // Use the actual claude dir if available
        let home = dirs::home_dir().unwrap_or_default();
        let claude_dir = home.join(".claude");
        if claude_dir.exists() {
            let mtime = compute_source_mtime(&claude_dir);
            assert!(mtime > 0, "Real claude dir should have files with mtime > 0");
        }
    }
}