export-messageslisted
Install: claude install-skill systemoperators/claude-plugins
# export imessage conversations to markdown
Exporter is a Mac app with a command line, `exporter`. It reads the Messages database on the Mac and writes one Markdown file per conversation. macOS only, everything stays on the Mac.
## 1. check the command
command -v exporter
Not found? `ls -d /Applications/*Exporter*.app`
- no app: ask the human to install Exporter from https://apps.apple.com/us/app/notesexporter/id6741618455?mt=12 and open it.
- app, no command: ask the human to open Exporter, press "copy install command" on the Command Line card and paste it once in Terminal (the sandboxed app cannot write to PATH; the line may need sudo).
The command line never prompts. In the app, the human connects Messages (choosing `~/Library/Messages` itself) and a Messages export folder. Connecting Contacts too links each participant to their contact card.
Then `exporter doctor`: `ok messages database readable (...)` means ready; a `FAIL` line is followed by its `fix:`.
## 2. export
Into the Messages export folder set in the app, incremental (only conversations that changed):
exporter sync --source messages --json --quiet
Into another folder inside one the human granted in the app (Command Line card, "add folder"):
exporter export --source messages --dest ~/Backups/messages --json --quiet
exporter export --source messages --dest ~/Backups/messages --dry-run
Messages is always every conversation as Markdown: `--folder`, `--tag` and `--format html` are ignor