Skip to content

claude_code_usage

Token and cost rollup from local Claude Code session JSONL files. Aggregates assistant turns under the chosen since window and groups them by project, model, or day. Pricing is bundled, so the splash works offline.

KindSafetyShapes
cachedSafetext, text_block, markdown_text_block, entries, bars, number_series, badge
OptionTypeRequiredDefaultDescription
since"today" | "7d" | "30d" | "all"no"today"Window the rollup covers, anchored on the current UTC day.
limitinteger (1..=50)no10Maximum rows surfaced by multi-row shapes (Bars, Entries, …).
group_by"project" | "model" | "day"no"project"Axis used by Bars / Entries / TextBlock row shapes.
ShapeRenderers
textanimated_boot, animated_figlet_morph, animated_postfx, animated_scanlines, animated_splitflap, animated_typewriter, animated_wave, text_ascii, text_plain
text_blockanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, list_plain
markdown_text_blocktext_markdown
entriesanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_table
barsanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, chart_bar, chart_pie, list_ranking
number_seriesanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, chart_histogram, chart_sparkline
badgeanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, status_badge
                                                            
                                     
                                        
                                  
                                                                                
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "text_ascii"
Today: 3.4M tokens / $12.34             
                                        
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "text_plain"
Today: 3.4M tokens / $12.34             
splashboard  2.1M / $7.20               
playground   1.3M / $5.14               
                                        
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "list_plain"
Today: 3.4M tokens / $12.34             
                                        
- splashboard  2.1M / $7.20            
- playground  1.3M / $5.14             
                                        
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "text_markdown"
splashboard                 2.1M / $7.20
playground                  1.3M / $5.14
                                        
                                        
                                        
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "grid_table"
                                     
                                     
                                  
                                  
                                  
                                  
                                  
spl pla                                 
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "chart_bar"
                                        
                    splashboard 61.8% 
                             
        playground 38.2%  
                         
                       
                         
                           
                             
                                       
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "chart_pie"
1. splashboard                     $7.20
2. playground                      $5.14
                                        
                                        
                                        
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "list_ranking"
                                
                                
                                
                                
        
        
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "chart_histogram"
                                       
                                      
·                                  
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "chart_sparkline"
 Today $12.34                          
[[widget]]
id = "claude_code_usage"
fetcher = "claude_code_usage"
render = "status_badge"