glab(1)                                                                glab(1)



NAME
       glab-todo-list - List your to-do items.



SYNOPSIS
       glab todo list [flags]



DESCRIPTION
       By default, lists your pending to-do items. Use --state to show done or
       all items instead.


       Narrow the results with --action to filter by why an item was created,
       or --type to filter by its target type.



OPTIONS
       -a, --action=""     Filter by action: assigned, mentioned,
       build_failed, marked, approval_required, directly_addressed.


       --jq=""   Filter JSON output with a jq expression.


       -F, --output="text"      Format output as: text, json.


       -p, --page=1   Page number.


       -P, --per-page=30   Number of items to list per page.


       -s, --state="pending"    Filter by state: pending, done, all.


       -t, --type=""  Filter by target type: Issue, MergeRequest.



OPTIONS INHERITED FROM PARENT COMMANDS
       -h, --help[=false]  Show help for this command.



EXAMPLE
       glab todo list
       glab todo list --state=done
       glab todo list --action=assigned
       glab todo list --type=MergeRequest
       glab todo list --output=json




SEE ALSO
       glab-todo(1)

Auto generated by spf13/cobra      Sep 2026                            glab(1)