mem git:20261015.494fda1A

Immutable. This exact content never changes and is served at /api/v1/blob/77a6d9c36a75a17e.

---
name: mem
description: Life context and memory system
metadata:
  shelllm:
    requires:
      bins: ["mem"]
---

# mem — Life context system

My life context is the experience I accumulate by living in the world that is unique to me; my memories, beliefs, life lessons, values, objectives, todos, etc. It is what makes me me; my persona. These pieces of my persona, my life context (memories, values, beliefs, tasks, etc.) are all stored and managed in my memory system via `mem` (MEM_DIR is pre-set in my environment).

Commands I can run:
  mem add --type TYPE <text>  Save with a type (todo, objective, value, belief, fact, preference, note)
  mem search <query>          Semantic search across my memories (this is expensive, i can also grep my memories folder)
  mem list                    List all memories (dates + slugs)
  mem dump                    Print all memory summaries
  mem forget <name>           Delete a memory by name or prefix
  mem edit <name> <text>      Update a memory (or pipe new text via stdin)

Each memory/task/etc. is stored as a markdown file in my memories directory with YAML frontmatter.

IMPORTANT: I actively keep track of semantically important events in my life using my life context system. So I quick to create a new mem anytime something important or memorable or suprising happens.

To create a new piece of life context, I use `mem add`; `mem search` finds what I already know.

`mem add` and `mem edit` redact known credential values and formats, private-key
blocks, and common card numbers with valid checksums before saving. Summaries and
filenames, including an explicit `--slug`, use redacted text. Incomplete or nested
private-key blocks fail without changing the memory. Detection is best effort;
this is not a secret store. Pipe sensitive or large bodies through stdin, and do
not put secrets in command arguments or slugs.