dotiphant

Use cases

Ask AI about a WhatsApp chat export

Export the chat with WhatsApp's own "Export chat", then run dotiphant import on the file. The chat joins a local archive on your computer, where you can search it, export it as Markdown, and let your AI assistant read it. Nothing connects to WhatsApp, and Dotiphant never logs in to it. Import is experimental: it is tested with sample files, not yet with many real exports.

Why not just paste the file into a chat?

For a short chat, pasting works. A long group chat quickly gets too big for one prompt, and the export's raw format, with phone-specific date styles and media placeholders, is hard to search. After an import, your AI assistant can search the chat and read only the parts it needs, and you can ask follow-up questions without pasting anything again.

1. Export the chat in WhatsApp

  • iPhone: open the chat, tap the contact or group name, then Export Chat.
  • Android: open the chat, tap the three dots, then More > Export chat.

Choose "Attach media" if you want photos and files too. Save the .zip (or the .txt) on your computer.

2. Import it

  1. Install Dotiphant, if you have not yet. Importing a WhatsApp export needs no Telegram login and no API id.
    curl -fsSL https://dotiphant.com/install.sh | sh
  2. Import the file. --me is your name exactly as the export shows it, so your own messages are marked as yours.
    dotiphant import "WhatsApp Chat - Clara.zip" --me "Your Name"

The path can be the .zip, the chat .txt, or the unpacked folder. Dotiphant detects a WhatsApp export by itself; --source whatsapp forces it. Useful options:

  • --copy-media copies attached photos and files from the .zip or folder into the archive.
  • --title "Chat name" sets the chat name. By default it comes from the file name.
  • --tz Europe/Berlin sets the time zone of the export. The export has local times without a zone, so Dotiphant reads them in your computer's time zone. Use this if the export came from a phone in another zone, and use the same --tz for every export of that chat.
  • --date-order mdy (or dmy) when dates look wrong. Dotiphant tells day-first from month-first by looking at the whole file. If the file cannot tell, it says so and uses day-first.

Supported: iPhone and Android exports, 12 and 24 hour clocks, messages over several lines, system lines like "X added Y", media placeholders, deleted messages and the "edited" marker. A chat with more than two people is stored as a group.

3. Ask your AI about it

Connect your AI app once. Claude Desktop, Claude Code, Codex and Cursor work locally:

dotiphant connect claude-desktop  # or claude-code, codex, cursor

Restart the app, then ask in plain words: "What did Clara and I decide about the flat?" or "Summarize the group chat from last month." The assistant searches the archive and reads the messages it needs. ChatGPT and claude.ai on the web work too, through remote access.

Prefer the terminal? Search the chat, or hand a Markdown transcript to any AI tool:

dotiphant search "deposit" --chat "Clara"dotiphant export "Clara" --since 2026-09-01 --out clara.mddotiphant open  # browse it in the viewer

Importing a newer export

WhatsApp chats are never synced: Dotiphant has no live link to WhatsApp, so the archive holds what you imported. To add newer messages, export the chat again and import it again. The chat name decides which chat the messages go to. Importing the same export twice adds nothing. A newer export adds only messages that are not stored yet: a message counts as stored when its time, sender and text match. A message edited between two exports is added again in its new form. Nothing is ever deleted.

Honest limits

  • A live WhatsApp connection is not supported. WhatsApp has no official API for personal accounts, and an unofficial one may put your account at risk.
  • One export is one chat. Import each chat you want on its own.
  • When your AI app reads the chat, its provider receives those messages. The chat also holds the other person's messages, so think about what you share.
  • To remove an imported chat, run dotiphant forget CHAT. It deletes the chat and its media from the archive.

Dotiphant mainly archives Telegram. If you use both, both kinds of chats sit in the same archive, search and AI tools. See Search your whole Telegram history.

Install Dotiphant

Free and open source (MIT). macOS and Linux; Windows experimental. The command installs the latest GitHub release and opens the setup in your browser. It takes about five minutes.

The script is about 150 lines. Read it first, or see other ways to install. The installer verifies the download against the release checksums (SHA256SUMS) before installing. You can check signed build provenance with gh attestation verify; see Verify a download.

curl -fsSL https://dotiphant.com/install.sh | shdotiphant open  # setup opens in your browser

Updated . Something wrong or unclear? Open an issue.