Processing WhatsApp Exports

Converts raw WhatsApp exports into clean, chunked markdown files ready for reading. Fully offline.

Workflow

1. Process — run process-conversation.py. Safe to re-run: it extracts into exported/, regenerates all chunks. A newer export just overwrites and regenerates.
2. Check output — the script prints a summary including pending audio transcriptions.
3. Ask about transcription — if there are pending audio messages, ask the user if they want them transcribed.
4. Transcribe (if yes) — run transcribe-conversation-audios.py (see below).
5. Re-process — run process-conversation.py again to regenerate chunks with transcriptions inline.
6. Report — tell the user the output location and summary.

Running the processor

python3 ${CLAUDE_SKILL_DIR}/scripts/process-conversation.py "path/to/export.zip" --output-dir .