claude_subscription

Claude (Max plan) subscription utilisation as seen by Claude Code's OAuth credentials. Reads ~/.claude/.credentials.json and queries the undocumented oauth/usage endpoint, exposing every window the response carries (5-hour, 7-day, per-model and pool-specific siblings).

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

Options

Option	Type	Required	Default	Description
window	string (response key — e.g. "five_hour" / "seven_day" / "seven_day_sonnet" / "seven_day_omelette")	no	"five_hour"	Which window the single-value shapes (Ratio, Badge) report. Multi-row shapes always list every non-null window the response carries.

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 2h │█░░░░░░░░░░░░░░░░░░│▮ 7%
               └───────────────────┘    
                                        

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

ratio via gauge_circle

███                                     
███          5h · resets 2h             
███                                     

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

ratio via gauge_line

5h · resets 2h: ▓░░░░░░░░░░░░░░░░░░░ 7% 

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

ratio via gauge_segment

                                        
                                        
5h · resets 2h ▱▱▱▱▱ 7%                 
                                        
                                        

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

ratio via gauge_thermometer

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

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

text via text_ascii

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

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

text via text_plain

5h 7% · 7d 2% · 7d Sonnet 0% · Claude De
                                        

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

text_block via list_plain

5h             7% · resets 2h           
7d             2% · resets 6d           
7d Sonnet      0% · resets 6d           
Claude Design  0% · resets n/a          

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

markdown_text_block via text_markdown

- 5h — 7% (resets 2h)                   
- 7d — 2% (resets 6d)                   
- 7d Sonnet — 0% (resets 6d)            
- Claude Design — 0% (resets n/a)       
                                        

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

entries via grid_table

5h                        7% (resets 2h)
7d                        2% (resets 6d)
7d Sonnet                 0% (resets 6d)
Claude Design            0% (resets n/a)
                                        

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

bars via chart_bar

███                                     
███                                     
███                                     
███                                     
███                                     
███ ███                                 
700 200                                 
5h  7d  7d  Cla                         

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

bars via chart_pie

                                        
         ●          ■ 5h 77.8%          
    ●●●●●●●●●●●                         
   ●●●●●●●●●●●●●    ■ 7d 22.2%          
  ●●●●●●●●●●●●●●●                       
 ●●●●●●●●●●●●●●●●●  ■ 7d Sonnet 0.0%    
  ●●●●●●●●●●●●●●●                       
   ●●●●●●●●●●●●●    ■ Claude Design 0.0%
    ●●●●●●●●●●●                         
         ●                              

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

bars via list_ranking

1. 5h                                 7%
2. 7d                                 2%
3. 7d Sonnet                          0%
4. Claude Design                      0%
                                        

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

badge via status_badge

● 5h 7%                                 

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

timeline via list_timeline

in 2h │ 5h resets                                 
      │ at 7%                                     
in 6d │ 7d resets                                 
      │ at 2%                                     
                                                  
                                                  
                                                  
                                                  

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