---
name: "glab-todo-list"
section: "1"
platform: "linux"
package: "glab"
version: "1.126.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/glab-todo-list"
---

# glab-todo-list(1)

List your to-do items.

## 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)](/glab-todo/1.md)**