docs(cli): document 19.1.0 list query flags#2922
Conversation
Document the new --where, --sort-asc, --sort-desc, --limit, --offset, --cursor-after, --cursor-before, and --select flags introduced in Appwrite CLI 19.1.0 on the commands reference page, and add a changelog entry highlighting the feature. The legacy --queries flag is still supported and is called out as the option for advanced or automation cases.
Greptile SummaryThis PR documents the new flag-based filtering, sorting, and pagination options ( Confidence Score: 5/5Safe to merge — documentation-only change with no runtime impact and all prior review issues resolved. Both files are pure Markdoc documentation. Previously flagged shell-safety issues (single-quote vs double-quote for No files require special attention. Important Files Changed
Reviews (4): Last reviewed commit: "update changelog" | Re-trigger Greptile |
- Quote $createdAt with single quotes so the shell does not expand it to an empty string in the example invocations. - Quote --where expressions with single quotes so > and < are not interpreted as shell redirection, and call this out in the flag description. - Drop the stale databases list-documents reference from the --select description; the rest of the page uses the rows/tables naming. - Use tables-db (the namespace exposed by the CLI) in the changelog example and in-prose command list, replacing the inaccurate databases list-rows / databases list-tables references.
Greptile flagged inconsistency between the new commands reference content (which used `databases list-rows` / `databases list-tables`) and the changelog (which uses `tables-db list-rows`). The actual CLI exposes these under the `tables-db` namespace, so the new commands section now matches both the changelog and the real CLI command names.
Summary
--where,--sort-asc,--sort-desc,--limit,--offset,--cursor-after,--cursor-before, and--select, with a worked example and a clear note that--queriesis still supported for advanced cases.2026-04-28.markdocannouncing the change.The new flags replace the previous workflow where users had to escape Appwrite query JSON inside
--queries, which is awkward in a shell. They are additive and fully backwards compatible — when both are passed, raw--queriesvalues are sent first and flag-generated queries are appended after.Test plan
/docs/tooling/command-line/commandsand confirm the new "Filter, sort, and paginate" section renders, the table is correctly formatted, and the in-page anchor#filter-sort-paginateworks.2026-04-28entry renders, with both arrow links resolving to the CLI commands reference and the CLI installation "Update your CLI" anchor.