Skip to content

codex_usage

Token and cost rollup from local Codex CLI session JSONL files. Aggregates per-turn usage under the chosen since window and groups it 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 = "codex_usage"
fetcher = "codex_usage"
render = "text_ascii"
Today: 1.8M tokens / $7.42              
                                        
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "text_plain"
Today: 1.8M tokens / $7.42              
splashboard  1.2M / $4.80               
image_gen    600k / $2.62               
                                        
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "list_plain"
Today: 1.8M tokens / $7.42              
                                        
- splashboard — 1.2M / $4.80            
- image_gen — 600k / $2.62              
                                        
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "text_markdown"
splashboard                 1.2M / $4.80
image_gen                   600k / $2.62
                                        
                                        
                                        
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "grid_table"
███                                     
███                                     
███                                     
███ ▄▄▄                                 
███ ███                                 
███ ███                                 
███ ███                                 
spl ima                                 
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "chart_bar"
                                        
         ●          ■ splashboard 66.7% 
    ●●●●●●●●●●●                         
   ●●●●●●●●●●●●●    ■ image_gen 33.3%   
  ●●●●●●●●●●●●●●●                       
 ●●●●●●●●●●●●●●●●●                      
  ●●●●●●●●●●●●●●●                       
   ●●●●●●●●●●●●●                        
    ●●●●●●●●●●●                         
         ●                              
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "chart_pie"
1. splashboard                     $4.80
2. image_gen                       $2.62
                                        
                                        
                                        
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "list_ranking"
████████                                
████████                                
████████████████                        
████████████████                        
████████████████        ████████████████
████████████████        ████████████████
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "chart_histogram"
     ▂█                                 
    ▁██                                 
·▁▂▆███                                 
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "chart_sparkline"
● Today $7.42                           
[[widget]]
id = "codex_usage"
fetcher = "codex_usage"
render = "status_badge"