llm-tokei 0.1.6

Token usage stats CLI for Codex and OpenCode 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
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

use chrono::{DateTime, Utc};
use serde::Serialize;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize)]
pub enum Source {
  Codex,
  OpenCode,
  Claude,
  Copilot,
  CopilotCli,
}

impl Source {
  pub fn as_str(&self) -> &'static str {
    match self {
      Source::Codex => "codex",
      Source::OpenCode => "opencode",
      Source::Claude => "claude",
      Source::Copilot => "copilot",
      Source::CopilotCli => "copilot-cli",
    }
  }
}

impl std::fmt::Display for Source {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    f.write_str(self.as_str())
  }
}

#[derive(Debug, Clone, Serialize)]
pub struct UsageRecord {
  pub source: Source,
  pub session_id: String,
  pub session_title: Option<String>,
  pub project_cwd: Option<String>,
  pub project_name: Option<String>,
  pub provider: Option<String>,
  pub model: Option<String>,
  pub ts: DateTime<Utc>,
  pub prompt: u64,
  pub completion: u64,
  pub input_bytes: u64,
  pub output_bytes: u64,
  pub input_estimated: bool,
  pub output_estimated: bool,
  pub input_bytes_estimated: bool,
  pub output_bytes_estimated: bool,
  pub reasoning: u64,
  pub cache_read: u64,
  pub cache_write: u64,
  /// Source-reported total token count when available. This is stored as-is
  /// from the upstream entry and may differ from the derived display total.
  pub total_direct: Option<u64>,
  pub mode: Option<String>,
  pub agent: Option<String>,
  pub is_compaction: bool,
  /// Number of user-initiated rounds (prompts) in this record.
  pub rounds: u64,
  /// Number of total API calls (including tool-call continuations) in this record.
  pub calls: u64,
  /// Cost reported by the source (e.g. OpenCode); USD.
  pub cost_embedded: Option<f64>,
}

impl UsageRecord {
  /// Displayed input includes prompt and cache traffic.
  pub fn display_input(&self) -> u64 {
    self
      .prompt
      .saturating_add(self.cache_read)
      .saturating_add(self.cache_write)
  }

  /// Displayed output includes visible completion and reasoning.
  pub fn display_output(&self) -> u64 {
    self.completion.saturating_add(self.reasoning)
  }

  /// Display total uses the displayed input/output columns as-is.
  pub fn total(&self) -> u64 {
    self.display_input().saturating_add(self.display_output())
  }
}