# Filters

There's a basic filter/query language built into wdid. You can use it to filter results in a powerful way. To use it, pass an argument to the default list command in filter form (passing a flag `--filter` also works):

```
# show me all of the items tagged "#pr", with a status of "waiting" from this week.
$ wdid "tag=#pr,status=waiting,time=week"

# show me all of the items tagged "#pr" and "@josler"
$ wdid "tag=#pr,tag=@josler"

# listing items not done within a group
$ wdid "status!=done,group=my group"
```

The filters should be passed as a list of filter objects separated by a comma `,`.

The format of each filter is: `{type_of_filter}{conditional}{value}`. The supported types of filter at this time are: `tag`, `status`, `time`, and `group`. The tag and status values should be a valid tag (`@josler`) or status (`done`) and the value for a time filter is in wdid [time format](https://j-osler.gitbook.io/wdid/advanced/time-format). The group filter uses the [group](https://j-osler.gitbook.io/wdid/advanced/groups) name.

Currently, these filters are an AND filter - they must all be true for an item for it to be included in the list. Further, there are limits to which conditional can be used with each type:

* `=` - `tag`, `status`, `time`, `group`
* `!=` - `tag`, `status`, `group`
* `>` - `time`
* `<` - `time`

Please note that `<` and `>` are *inclusive* (so really `>=`).

```
# show me all of the items _not_ tagged #pr but tagged @josler, earlier than this week
$ wdid -f "tag!=#pr,tag=@josler,time<this week"
```

Note that a status filter like `"status=done,status=bumped"` will never match, an item can't be done and waiting.

### Matching More Than One **Status**

In order to ask for items that match one status or another status, you can use either a `!=` or use the `|` operator (only works for statuses!):

```
# functionally equivalent
$ wdid "status!=waiting"
$ wdid "status=done|skipped|bumped"
```