usage

Documentation

Overview

Package usage parses Claude Code JSONL session logs and aggregates token counts. Malformed lines and files degrade gracefully: usage is best-effort, never fatal.

Index

• type Totals
  • func Aggregate(configDir string) (Totals, error)
  • func (t Totals) Total() int

Types

type Totals

type Totals struct {
	Input       int
	Output      int
	CacheCreate int
	CacheRead   int
}

Totals holds aggregated token counts across all session logs.

func Aggregate

func Aggregate(configDir string) (Totals, error)

Aggregate walks <configDir>/projects recursively, sums token counts from every *.jsonl file, and returns the combined Totals. A missing projects directory yields zero Totals and a nil error. Individual unreadable files and malformed or usage-less lines are skipped rather than failing the walk.

func (Totals) Total

func (t Totals) Total() int

Total returns the sum of every token bucket.