# Mem0 cli-v0.2.11 — Mem0 Python CLI (v0.2.11)

- Product: Mem0 (https://whatsnew.fyi/product/mem0)
- Vendor: Mem0
- Date: 2026-08-04
- Version: cli-v0.2.11
- Original notes: https://github.com/mem0ai/mem0/releases/tag/cli-v0.2.11
- Permalink: https://whatsnew.fyi/product/mem0/releases/cli-v0.2.11

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Add `--custom-instructions`, `--custom-categories`, `--structured-data-schema`, and `--timestamp` flags to the `add` command
- **added** — Add `--show-expired`, `--reference-date`, and `--latest-only` flags to the `search` command
- **added** — Add `--show-expired` and `--latest-only` flags to the `list` command
- **added** — Add `--expires` and `--timestamp` flags to the `update` command
- **added** — Add `--delete-linked` flag to the `delete` command to also delete memories linked to the target memory
- **fixed** — Fix `help --json` to emit JSON automatically under agent mode without requiring the `--json` flag to be passed explicitly
- **changed** — Remove `--categories` flag from the `add` command and exit with an error message directing users to use `--custom-categories` instead
- **security** — Tighten the `postcss` pnpm override from `<8.5.10 → >=8.5.10` to `<8.5.18 → >=8.5.18 <9.0.0` to close a newer CVE range

**New Features:**
- **`add`:** New `--custom-instructions`, `--custom-categories`, `--structured-data-schema`, and `--timestamp` flags, matching the Platform `/v3/memories/add/` payload fields (Python and Node [#6696](https://github.com/mem0ai/mem0/pull/6696))
- **`search`:** New `--show-expired`, `--reference-date`, and `--latest-only` flags, forwarded to `/v3/memories/search/` as `show_expired`, `reference_date`, and `latest_only` (Python and Node [#6696](https://github.com/mem0ai/mem0/pull/6696))
- **`list`:** New `--show-expired` and `--latest-only` flags (Python and Node [#6696](https://github.com/mem0ai/mem0/pull/6696))
- **`update`:** New `--expires` and `--timestamp` flags (Python and Node [#6696](https://github.com/mem0ai/mem0/pull/6696))
- **`delete`:** New `--delete-linked` flag to also delete memories linked to the target memory (Python and Node [#6696](https://github.com/mem0ai/mem0/pull/6696))

**Bug Fixes:**
- **`help --json`:** Emit JSON automatically under agent mode (`--agent`), not only when `--json` is passed explicitly. Python checks `is_agent_mode()` and now renders through `console.print_json()` instead of a plain `console.print(json.dumps(...))` call; Node also checks the root `--agent` flag in addition to the subcommand's `--json` flag (Python and Node [#6773](https://github.com/mem0ai/mem0/pull/6773))

**Changes:**
- **`add`:** `--categories` is no longer forwarded on `add`. The `/v3/memories/add/` payload has no `categories` field (only `custom_categories`), so the CLI was sending a key the endpoint does not accept. Passing the flag now exits 1 with a message pointing to `--custom-categories` (Python and Node [#6696](https://github.com/mem0ai/mem0/pull/6696))

**Security:**
- **Dependencies (Node):** Tighten the `postcss` pnpm override from `<8.5.10 → >=8.5.10` to `<8.5.18 → >=8.5.18 <9.0.0`, closing a newer CVE range the previous floor didn't cover, as part of a wider dependency patch sweep across the pnpm workspaces ([#6639](https://github.com/mem0ai/mem0/pull/6639))