1. Synopsis
The task working set: a direct indexed scan with blockers, never ranked retrieval.
memhtml task list [options]2. Arguments
This command takes no positional arguments.
3. Flags
| Flag | Type | Default | Values | Description |
|---|---|---|---|---|
--status |
string | no default | todo, doing, blocked, done |
One task status. |
--workspace |
string | no default | no fixed set | One workspace. |
--due-before |
string | no default | no fixed set | An ISO date. Returns tasks due strictly before it, by calendar day. |
--limit |
integer | 50 |
no fixed set | Rows per page. |
--cursor |
string | no default | no fixed set | The next_cursor from the previous page: the last path returned. |
--include-archived |
flag | false |
no fixed set | Include finished tasks. done archives, so they are otherwise absent. |
--detected |
flag | false |
no fixed set | Only tasks the sleep cycle detected, never ones opened by hand. The machine’s queue: each is a proposal carrying the evidence it was detected from. |
Every command also accepts the global flags.
4. Response
On success the command writes one JSON envelope to stdout, and its type is task.list.
On failure it writes the failure envelope, whose code comes from error codes.
The JSON envelope gives the fields both shapes carry. Response types lists every value type takes across the binary.
5. Further reading
No guide block names this command. The guide is the workflow prose the CLI ships beside the command table: which command to reach for, and in what order.
6. Provenance
A loader generates this page from apps/cli/src/commands.ts while the site builds, so no file in the repository holds it: the COMMANDS array there is the one source of argument parsing, of memhtml manifest, and of AGENTS.md. Change the registry and this page changes with it.