Filters

Narrow your backlog to exactly what you need. All filters work with xpo list on the CLI and the web board's filter controls, and they can be combined freely.

Status

xpo list --status PLANNED
xpo list -s DOING
xpo list -s BACKLOG -s PLANNED    # multiple statuses

Labels

xpo list --label bug
xpo list -l feature

Assignee

xpo list --assignee "Alice"       # substring match
xpo list --mine                   # assigned to you

Worked by

Issues are always assigned to a person, and agents work via that person (see Agent identity). In the web board, the Worked by filter splits assigned issues into Agent (an agent took it on someone's behalf) and Human. Unassigned issues match neither.

Filters

In JSON output, the agent shows up as assignee_via:

xpo list --json | jq '.issues[] | select(.assignee_via != null) | .id'

Time range

xpo list --since 1d               # updated in last day
xpo list --since 1w               # updated in last week
xpo list --since 2025-01-01       # updated since date
xpo list --before 2025-06-01      # updated before date

Parent

xpo list -p <epic-id>             # children of an epic

Cycle

xpo list --cycle current
xpo list --cycle next
xpo list --cycle 2025-06-23

Include completed/archived

By default, old terminal issues (DONE, CANCELED, DUPLICATE) are hidden:

xpo list --all                    # include old DONE/CANCELED/DUPLICATE
xpo list --archived               # include archived issues

In the web board

Press f (or click the filter button) in Issues, My Issues, or Notifications to open the filter menu: status, labels, assignee, worked by, priority, and more. Active filters appear as chips you can clear individually. Each tab saves its own filters, so switching tabs brings back that tab's filters.

Combining filters

All filters can be combined:

xpo list --status DOING --label feature --mine --since 1w