Skip to content

todoist_tasks

Todoist task snapshot, sorted by due date and priority, with structured filters for due window, projects, labels, and priority. Badge summarises overdue/total counts; list shapes show each task with its due label and priority and link back to the Todoist app.

KindSafetyShapes
cachedSafelinked_text_block, text, text_block, entries, timeline, badge
OptionTypeRequiredDefaultDescription
tokenstringnoTodoist API token. If omitted, TODOIST_TOKEN env var is used.
filter_due"today" | "overdue" | "upcoming" | "all"no"all"Due-date window.
filter_include_overduebooleannotrueWhen filter_due = "today", include overdue tasks too.
filter_projectsarray of stringsnoProject names matched as an OR clause (#ProjectA | #ProjectB).
filter_labelsarray of stringsnoLabel names matched as an OR clause (@urgent | @backend).
filter_prioritiesarray of integers (1..=4)noPriority filter matched as an OR clause (p1 | p2).
max_itemsinteger (1..=100)no10Maximum rendered tasks for list-like shapes (TextBlock/Entries/Timeline).
ShapeRenderers
linked_text_blocklist_links
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
entriesanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_table
timelineanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, list_timeline
badgeanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, status_badge
overdue · P4 Fix flaky CI on macOS runne
overdue · P3 Reply to design review feed
today · P1 Ship v2.3 release notes      
today · P2 Pair with @sam on auth refact
today · P3 Review @lin's PR #482        
[[widget]]
id = "todoist_tasks"
fetcher = "todoist_tasks"
render = "list_links"
                                                                  
                                 
                                       
                                    
                                                                                
[[widget]]
id = "todoist_tasks"
fetcher = "todoist_tasks"
render = "text_ascii"
todo 9 tasks (2 overdue · 4 today)      
                                        
[[widget]]
id = "todoist_tasks"
fetcher = "todoist_tasks"
render = "text_plain"
overdue · P4 Fix flaky CI on macOS runne
overdue · P3 Reply to design review feed
today · P1 Ship v2.3 release notes      
today · P2 Pair with @sam on auth refact
[[widget]]
id = "todoist_tasks"
fetcher = "todoist_tasks"
render = "list_plain"
Fix flaky CI on macOS runner      e · P4
Reply to design review feedback   e · P3
Ship v2.3 release notes           y · P1
Pair with @sam on auth refactor   y · P2
Review @lin's PR #482             y · P3
[[widget]]
id = "todoist_tasks"
fetcher = "todoist_tasks"
render = "grid_table"
Apr 17  Fix flaky CI on macOS runner             
        overdue · P4                             
Apr 18  Reply to design review feedback          
        overdue · P3                             
Apr 19  Ship v2.3 release notes                  
        today · P1                               
Apr 20  Pair with @sam on auth refactor          
        today · P2                               
[[widget]]
id = "todoist_tasks"
fetcher = "todoist_tasks"
render = "list_timeline"
 todo 9 (2 overdue)                    
[[widget]]
id = "todoist_tasks"
fetcher = "todoist_tasks"
render = "status_badge"