Explorar también las memorias de los proyectos

Claude Code deja, además de las sesiones, un directorio memory/ por proyecto:
un .md por recuerdo con frontmatter, y un MEMORY.md que hace de índice. Lo
que no figura en ese índice sigue en disco pero deja de cargarse en contexto,
así que la diferencia entre ambos es justamente lo que vale la pena mirar.

-m cambia de sesiones a memorias y reusa los mismos verbos:

  claude-sesiones -m                  tabla de memorias
  claude-sesiones -m docker           busca en nombre, descripción y cuerpo
  claude-sesiones -m -s 3             lee la nº 3 (o -s <nombre>)
  claude-sesiones -m --check          audita índices, enlaces y orígenes
  claude-sesiones -m -D 3             la borra y la saca de MEMORY.md
  claude-sesiones -m --type feedback  filtra por tipo declarado

--check es la parte con criterio propio: reporta memorias que no están en
MEMORY.md, entradas del índice que apuntan a archivos que ya no existen,
enlaces [[...]] rotos y sesiones de origen que ya no están.

El registro de una memoria usa claves cortas como el de sesiones, por el
mismo motivo: viaja embebido en el HTML, que ahora tiene su propia pestaña
de memorias.

Claude-Session: https://claude.ai/code/session_01RmtZ9qBemrc9TncwVTG6ED

1 files changed, 86 insertions, 4 deletions

diff --git a/README.md b/README.md
index 4252071..31756a2 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,8 @@ page you open with a double click.
 
 ## ⚠️ Your transcripts are private
 
-`--json` and `--html` write out **the full text of your conversations**: prompts,
+`--json` and `--html` write out **the full text of your conversations and your
+projects' memories**: prompts,
 answers, file paths, branch names. The generated `sesiones.html` is a complete,
 readable copy of everything you ever typed into Claude Code.
 
@@ -58,6 +59,7 @@ claude-sesiones -g "port already"   # search inside the conversations
 claude-sesiones -r 3                # print the command that resumes it
 eval "$(claude-sesiones -r 3)"      # …or resume it right away
 claude-sesiones --html --open       # build sesiones.html and open it
+claude-sesiones -m                  # your projects' memories
 ```
 
 The number is the row's position **in the table you are looking at**, so if you
@@ -86,6 +88,9 @@ claude-sesiones docker -s 2         # reads the 2nd of those three
 | `--template FILE` | Use your own template for `--html`. |
 | `--open` | Open whatever `--html` produced in your browser. |
 | `--no-cache` | Ignore the cache and re-parse everything. |
+| `-m`, `--memory` | Work on memories instead of sessions. |
+| `--type KIND` | With `-m`: filter by `project`, `user`, `feedback` or `reference`. |
+| `--check` | With `-m`: audit indexes, links and origin sessions. |
 
 ### Deleting sessions
 
@@ -101,6 +106,58 @@ claude-sesiones -p /tmp --delete-empty     # only the empty ones of that project
 It warns you about any file written in the last five minutes: that is very
 likely a session Claude Code still has open, and it will write it back on exit.
 
+## Project memory
+
+Claude Code stores per-project memories in
+`~/.claude/projects/<project>/memory/`: one `.md` per memory, with YAML
+frontmatter and a markdown body, plus a `MEMORY.md` that indexes them.
+
+**The index is the only part loaded into context when a session starts.** A
+memory that is on disk but missing from `MEMORY.md` stops being remembered even
+though the file is still there, so the gap between the two is worth watching.
+
+`-m` swaps the noun and reuses the verbs you already know:
+
+```bash
+claude-sesiones -m                  # table of memories
+claude-sesiones -m docker           # search name, description and body
+claude-sesiones -m --type user      # only one kind
+claude-sesiones -m -s 3             # read memory #3
+claude-sesiones -m -s deadlock      # same, by name
+claude-sesiones -m -p /home/u/proj  # only one project's
+```
+
+Claude picks the kind when it writes them: **project** is work in progress,
+**user** is who you are and how you work, **feedback** is corrections you gave,
+and **reference** points at external resources.
+
+### Auditing
+
+```bash
+claude-sesiones -m --check
+```
+
+Exits 1 if it finds anything, and reports:
+
+- projects with memories but no `MEMORY.md`;
+- memories missing from their project's index;
+- index entries pointing at a file that no longer exists;
+- `[[...]]` links with no target — the format allows them, they mark something
+  not written yet;
+- memories whose origin session is gone from disk: the memory outlived the
+  conversation that created it.
+
+### Deleting memories
+
+Same as sessions: irreversible, asks first unless you pass `-y`. Besides
+removing the file it drops its line from `MEMORY.md`, so the index is not left
+pointing at nothing.
+
+```bash
+claude-sesiones -m -D 3 --dry-run   # what it would delete
+claude-sesiones -m -D deploy-docker # delete that memory
+```
+
 ## The HTML page
 
 `claude-sesiones --html` produces one file with the data embedded inside it. No
@@ -159,9 +216,17 @@ A few details worth knowing:
 
 ### JSON schema
 
-`--json` prints an array, most recently active first. Keys are one letter
-because the same records are embedded in the HTML, where the cost is paid once
-per session:
+`--json` prints an object with two arrays: `s` holds the sessions, most
+recently active first, and `m` the memories, most recently modified first.
+
+```json
+{"s": [ … ], "m": [ … ]}
+```
+
+Keys are one letter because the same records are embedded in the HTML, where
+the cost is paid once per record.
+
+Each session in `s`:
 
 | Key | Meaning |
 | --- | --- |
@@ -180,6 +245,23 @@ per session:
 | `v` | Claude Code version. |
 | `c` | Transcript: `[{"r": "u"｜"a"｜"t", "x": text}]`. |
 
+Each memory in `m`:
+
+| Key | Meaning |
+| --- | --- |
+| `name` | Name from the frontmatter (or the filename, if missing). |
+| `file` | File name, with extension. |
+| `p` | Project path. |
+| `desc` | Description from the frontmatter. |
+| `ty` | Kind: `project`, `user`, `feedback` or `reference`. |
+| `src` | UUID of the session that wrote it, when declared. |
+| `body` | Markdown body, without the frontmatter. |
+| `ln` | `[[...]]` links found in the body. |
+| `k` | Size in KB. |
+| `l` | Last modified (ISO 8601). |
+| `ix` | `true` if listed in `MEMORY.md`. |
+| `hix` | `true` if the project has a `MEMORY.md`. |
+
 ## Development
 
 ```bash