Skip to content

linear_cycle

Linear cycle (sprint) progress — completed/total issues, days remaining, burndown sparkline. Ratio is the headline (completion fraction); NumberSeries carries the daily completed-count history; Bars breaks down issue states; Calendar highlights cycle days + issue due dates; Badge summarises on-track vs at-risk vs behind.

KindSafetyShapes
cachedSaferatio, text, text_block, markdown_text_block, linked_text_block, entries, number_series, bars, calendar, badge
OptionTypeRequiredDefaultDescription
tokenstringno—Linear personal API key (lin_api_*). Falls back to LINEAR_TOKEN env.
workspacestringno—Workspace slug for LinkedTextBlock URLs. Defaults to viewer's organization urlKey.
teamstringno—Team key (e.g. "ENG"). When omitted, the first active cycle the viewer can see is used.
cycle"current" | "next" | "previous" | integerno"current"Cycle to surface.
ShapeRenderers
ratioanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, gauge_battery, gauge_circle, gauge_line, gauge_segment, gauge_thermometer
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
linked_text_blocklist_links
entriesanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_table
number_seriesanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, chart_histogram, chart_sparkline
barsanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, chart_bar, chart_pie, list_ranking
calendaranimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_calendar
badgeanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, status_badge
                                        
         ┌────────────────────────┐     
Cycle 24 │██████████░░░░░░░░░░░░░░│▮ 42%
         └────────────────────────┘     
                                        
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "gauge_battery"
█████████████████                       
████████████████Cycle 24                
█████████████████                       
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "gauge_circle"
Cycle 24: ▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░ 42% 
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "gauge_line"
                                        
                                        
Cycle 24 ▰▰▱▱▱ 42%                      
                                        
                                        
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "gauge_segment"
         ╭─╮        
         │░│        
         │░│        
         │░│        
Cycle 24 │█│ 42%    
         │█│        
         │█│        
         ╰●╯        
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "gauge_thermometer"
▗▛▜▖        ▝█          ▟▀▙  ▟█             ▗█  █▀█   ▟▘ ▟█ ▟▀▜▖            █▀▀ 
█   █ █ ▟▀▙  █  ▟▀▙      ▄▛ ▟▘█              █   ▗▛  ▟▘ ▟▘█ █▗█▌     ▗▖     ▀▀▙ 
▜▖▗▖▜▄█ █ ▄  █  █▀▀     ▟▘▄ ▀▀█▘             █   █  ▟▘  ▀▀█▘█▛▐▌     ▝▘     ▄ █ 
 ▀▀ ▄▄▛ ▝▀▘ ▝▀▘ ▝▀▘     ▀▀▀  ▝▀▘            ▀▀▀  ▀  ▘    ▝▀▘▝▀▀             ▝▀▘ 
                                                                                
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "text_ascii"
Cycle 24 — 17/40 · 5d left              
                                        
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "text_plain"
Cycle 24                                
started 2026-04-22                      
ends 2026-05-06                         
completed 17/40                         
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "list_plain"
Cycle 24                                
                                        
- started 2026-04-22                    
- ends 2026-05-06                       
- completed 17/40                       
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "text_markdown"
Cycle 24 — 17/40 · 5d left              
                                        
                                        
                                        
                                        
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "list_links"
Cycle                                 24
Started                       2026-04-22
Ends                          2026-05-06
Completed                        17 / 40
Days left                              5
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "grid_table"
████████                                
████████                                
████████        ████████        ████████
████████        ████████        ████████
████████████████████████████████████████
████████████████████████████████████████
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "chart_histogram"
       ▅█                               
    ▁▆███                               
·▁▄▇█████                               
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "chart_sparkline"
███                                     
███                                     
███     ▇▇▇                             
███ ▂▂▂ ███                             
███ ███ ███                             
███ ███ ███ ▁▁▁                         
17█ █8█ 12█ █3█                         
Com In  Tod Can                         
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "chart_bar"
                                        
         ●          ■ Completed 42.5%   
    ●●●●●●●●●●●                         
   ●●●●●●●●●●●●●    ■ In Progress 20.0% 
  ●●●●●●●●●●●●●●●                       
 ●●●●●●●●●●●●●●●●●  ■ Todo 30.0%        
  ●●●●●●●●●●●●●●●                       
   ●●●●●●●●●●●●●    ■ Canceled 7.5%     
    ●●●●●●●●●●●                         
         ●                              
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "chart_pie"
1. Completed                          17
2. In Progress                         8
3. Todo                               12
4. Canceled                            3
                                        
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "list_ranking"
     April 2026             
 Su Mo Tu We Th Fr Sa       
           1  2  3  4       
  5  6  7  8  9 10 11       
 12 13 14 15 16 17 18       
 19 20 21 22 23 24 25       
 26 27 28 29 30             
                            
                            
                            
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "grid_calendar"
● Cycle 24 at risk                      
[[widget]]
id = "linear_cycle"
fetcher = "linear_cycle"
render = "status_badge"