---
title: memhtml task list
description: "The task working set: a direct indexed scan with blockers, never ranked retrieval."
---

## 1. Synopsis

The task working set: a direct indexed scan with blockers, never ranked retrieval.

```sh
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](/reference/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](/reference/error-codes/).

[The JSON envelope](/reference/envelope/) gives the fields both shapes carry. [Response types](/reference/response-types/) lists every value `type` takes across the binary.

## 5. Further reading

No guide block names this command. The [guide](/reference/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.