codex_subscription

Codex CLI subscription utilisation, parsed from the local session JSONL. Each token_count event Codex writes carries the 5h (primary) and 7d (secondary) rate-limit windows; we read the most recent one. No HTTP — re-fetching this would mean making a billable inference call.

Kind	Safety	Shapes
cached	Safe	ratio, text, text_block, markdown_text_block, entries, bars, badge, timeline

Options

Option	Type	Required	Default	Description
window	"5h" | "7d" | "primary" | "secondary"	no	"5h"	Which window the single-value shapes (Ratio, Badge) report. Multi-row shapes always list both windows.

Compatible renderers

Shape	Renderers
ratio	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, gauge_battery, gauge_circle, gauge_line, gauge_segment, gauge_thermometer
text	animated_boot, animated_figlet_morph, animated_postfx, animated_scanlines, animated_splitflap, animated_typewriter, animated_wave, text_ascii, text_plain
text_block	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, list_plain
markdown_text_block	text_markdown
entries	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_table
bars	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, chart_bar, chart_pie, list_ranking
badge	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, status_badge
timeline	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, list_timeline

Preview

ratio via gauge_battery

                                        
               ┌──────────────────┐     
5h · resets 3h │███░░░░░░░░░░░░░░░│▮ 18%
               └──────────────────┘     
                                        

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "gauge_battery"

ratio via gauge_circle

███████                                 
███████      5h · resets 3h             
███████                                 

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "gauge_circle"

ratio via gauge_line

5h · resets 3h: ▓▓▓░░░░░░░░░░░░░░░░ 18% 

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "gauge_line"

ratio via gauge_segment

                                        
                                        
5h · resets 3h ▰▱▱▱▱ 18%                
                                        
                                        

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "gauge_segment"

ratio via gauge_thermometer

░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░
████████████████████

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "gauge_thermometer"

text via text_ascii

▐▛▘             ▝▜▌     █▀▀ ▜▌      ▗█  ▟▀▙ ▄ ▗▖            █▀█  ▝█     █▀█ ▄ ▗▖
▐▌  ▜▞▜▖▜▟▜▖▟▀▙  ▐▌     ▀▀▙ ▐▙▜▖     █  ▜▄▛ ▀▗▛              ▗▛ ▗▄█      ▗▛ ▀▗▛ 
▐▌  ▐▙▟▘▐▌▝▘█ █  ▐▌     ▄ █ ▐▌▐▌     █  █ █ ▗▛▗▖             █  █ █      █  ▗▛▗▖
▝▀▘ ▟▙  ▀▀  ▝▀▘ ▝▀▘     ▝▀▘ ▀▘▝▘    ▀▀▀ ▝▀▘ ▀ ▝▘             ▀  ▝▀▝▘     ▀  ▀ ▝▘
                                                                                

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "text_ascii"

text via text_plain

[pro] 5h 18% · 7d 7%                    
                                        

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "text_plain"

text_block via list_plain

plan: pro                               
5h  18% · resets 3h                     
7d   7% · resets 5d                     
                                        

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "list_plain"

markdown_text_block via text_markdown

plan: pro                               
                                        
- 5h — 18% (resets 3h)                  
- 7d — 7% (resets 5d)                   
                                        

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "text_markdown"

entries via grid_table

plan                                 pro
5h                       18% (resets 3h)
7d                        7% (resets 5d)
                                        
                                        

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "grid_table"

bars via chart_bar

███                                     
███                                     
███                                     
███                                     
███ ▅▅▅                                 
███ ███                                 
███ 700                                 
5h  7d                                  

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "chart_bar"

bars via chart_pie

                                        
         ●          ■ 5h 72.0%          
    ●●●●●●●●●●●                         
   ●●●●●●●●●●●●●    ■ 7d 28.0%          
  ●●●●●●●●●●●●●●●                       
 ●●●●●●●●●●●●●●●●●                      
  ●●●●●●●●●●●●●●●                       
   ●●●●●●●●●●●●●                        
    ●●●●●●●●●●●                         
         ●                              

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "chart_pie"

bars via list_ranking

1. 5h                                18%
2. 7d                                 7%
                                        
                                        
                                        

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "list_ranking"

badge via status_badge

● 5h 18%                                

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "status_badge"

timeline via list_timeline

in 3h │ 5h resets                                 
      │ at 18%                                    
in 5d │ 7d resets                                 
      │ at 7%                                     
                                                  
                                                  
                                                  
                                                  

[[widget]]
id = "codex_subscription"
fetcher = "codex_subscription"
render = "list_timeline"