diff --git a/b738f2842db428df1b4aad0192a7f36c/comments/91b801a9b6b77cca66ae5ab0b7d97cca/description b/b738f2842db428df1b4aad0192a7f36c/comments/91b801a9b6b77cca66ae5ab0b7d97cca/description
new file mode 100644
index 0000000..b3fd943
--- /dev/null
+++ b/b738f2842db428df1b4aad0192a7f36c/comments/91b801a9b6b77cca66ae5ab0b7d97cca/description
@@ -0,0 +1,38 @@
+# `ent list FILTER` filter format
+
+I'm not sure about the filter format, but here are some notes...
+
+There are (as of df7b5c6aa4a00dfca66dc802f1e813f23f27a5b9) two independent
+filters: "state" and "assignee".  The "state" filter defaults to
+including issues whose state is InProgress, Blocked, Backlog, or New.
+The "assignee" filter defaults to including all issues, assigned or not.
+
+The two filters can be independently overridden by the `ent list
+FILTER` command.  FILTER is a string containing "chunks" separated by
+":", like the PATH environment variable.  Each chunk is of the form
+"name=value[,value...]".  "name" can currently be either "state" or
+"assignee", and we can add more in the future (e.g "tag" or "ctime").
+
+The "value" arguments to the "state" filter must be one of the valid
+states, or it's a parse error.
+
+The "value" arguments to the "assignee" filter are used to
+string-compare against the issues "assignee" field, exact matches are
+accepted and everything else is rejected.  A special assignee filter of
+the empty string matches issues that don't have an assignee.
+
+Some examples:
+
+* `ent list` shows issues in the states listed above, and don't filter
+  based on assignee at all.
+
+* `ent list assignee=seb` shows issues in the states listed above,
+  but only if the assignee is "seb".
+
+* `ent list assignee=seb,` shows issues in the states listed above,
+  but only if the assignee is "seb" or if there is no assignee.
+
+* `ent list state=done` shows all issues in the Done state.
+
+* `ent list state=inprogress:assignee=seb` shows issues in the InProgress
+  state that are assigned to "seb".