people-memories

# People memories skill

## Purpose
Keep a short-lived, searchable memory vault about people you talk to so your assistant can recall follow-ups instantly. The skill handles:
- `remember` cues (voice or text) to persist comments, preferences, and context.
- Summaries + exports so you can package a person’s “fact card.”
- Search, recall, and list commands for quick lookups.
- Optional auto-trigger from voice transcripts (when you say “remember …”).

## Structure & storage
`~/.clawdbot/people-memory.json` now stores:
```
{
  "people": {
    "alex": {
      "displayName": "Alex",
      "notes": [
        {
          "timestamp": "2026-01-29T12:05:00Z",
          "note": "Likes cats and doing late-night music practice",
          "source": "voice",
          "tags": ["pets", "music"]
        }
      ]
    }
  },
  "index": {
    "music": ["alex"],
    "cats": ["alex"]
  }
}
```
- Names are normalized (lowercase keys) but store the display name.
- Each note captures `timestamp`, `note`, `source`, and `tags`.
- An `index` map keeps keywords → people for super-fast lookups.

## CLI commands
Use the bundled script to manage the database:
```
skills/people-memories/scripts/people_memory.py <command> [options]
```
- `remember --person Alex --note "loves chai" --tags drinks,preferences` – adds a note.
- `recall --person Alex --limit 3` – reads the latest notes.
- `summarize --person Alex` – prints fact card with counts, tags, last updates.
- `search --query coffee` – finds people whose notes mention “coffee”.
- `export --person Alex --format md --out ~/Desktop/alex.md` – dumps the notes as Markdown (or JSON). 
- `list` – enumerates everyone stored plus note counts.

## Auto capture (voice/chat)
The `extensions/people-memories` extension listens to `/voice-chat` transcripts. When you say something like “remember Alex likes cats,” it automatically runs the `remember` command and logs the note. The index updates in the background, and we keep confirmations quiet unless you explic...