Skip to content
DocsImport chat history

Start

Import chat history

Add your Claude chat history from its data export: how to get the export, the import command, what is read and kept, and what a chat export cannot show.

On this page

Coding agents keep their history in folders AI Insights reads on its own. A chat product such as Claude (claude.ai and the Claude apps) keeps your conversations on its servers, so you request a data export, download it, and point AI Insights at the file. It never looks in your downloads folder by itself.

Get your Claude export

  1. Open claude.ai on a computer (the web app or Claude Desktop). The phone apps cannot export.
  2. Click your name, then Settings, then Privacy.
  3. Click Export data and choose a date range.
  4. Open the email within 24 hours and download the export. You have to be signed in, and the link may work only once.
  5. Keep the “conversations” zip and run npx ai-insights@latest import claude <path>. The other files are not needed.

Export is available on the Free, Pro, Max and Ultra plans. On a Team or Enterprise plan it works only if an owner allows it. The export does not include files you uploaded or Office and PDF files Claude made. See Anthropic's Export your Claude data.

Newer exports arrive as one zip per kind of data (conversations-000.zip, projects-000.zip, memories-000.zip, light_metadata-000.zip, with more parts as -001 and so on), sometimes with a manifest-*.json; older ones are a single data-…-batch-0000.zip. Point AI Insights at the conversations zip, the folder holding the parts, or the manifest: it reads every conversations part and never opens the others.

Other chat products

ChatGPT: coming next. The importer will read its export once it has been checked against a real one. To get it ready: in ChatGPT, open Settings, then Data controls, then Export data, and confirm. The email can take up to 7 days and its link expires after 24 hours. Business and Enterprise workspaces cannot export this way. See OpenAI's How do I export my ChatGPT history and data?

  • Gemini: not supported yet. Its history comes from Google Takeout, under My Activity, then Gemini Apps.
  • Microsoft Copilot: not supported yet. Its history downloads as a CSV from the Microsoft privacy dashboard.

Import it

Terminal
npx ai-insights@latest import claude ~/Downloads/<your-export>.zip

The path can be any of:

  • the export .zip as you downloaded it (it is read in place and never unpacked to disk);
  • the folder you unzipped it into, or a folder holding several conversations-*.zip parts;
  • the conversations.json file itself.

The file is read a piece at a time, so a large history does not need much memory: an export of about 1,300 conversations (a 76 MB conversations.json) imports in about a second. From then on every run includes your chats as their own agent, Claude chat (claude-chat in --harness), separate from Claude Code.

Output, from a synthetic export
Imported your Claude chat history
  Claude chat  300 conversations, 2026-03-01 to 2026-09-16
               964 prompts, 964 replies, 277 tool calls
               imported 2026-11-17

Kept: counts, tool names and your own prompts. Not kept: Claude's answers, thinking, tool results,
attachments and chat titles. Tokens and cost are not in the export, so they stay unmeasured.
Run `ai-insights` to see it in your report.

What is read and kept

Each conversation becomes one session, the same shape as a coding agent's, stored under ~/.ai-insights/imports/claude-chat/. The export itself is not copied.

What an import keeps
From the exportKept
Your own messagesAs prompts, with secrets and email addresses redacted and each cut to 2,000 characters. Only what you typed: text the product added to a message and attachment text are not prompts. A message with only an attachment counts as a turn with no words.
When each message was sentTimes, for activity, streaks, your hour of day and how fast you replied.
Claude's repliesCounted only. The text is never read into memory.
ThinkingHow many times Claude thought and for how long. The thinking text is not read.
Tools Claude usedClaude's own tools by name (web search, artifacts, code execution, file creation and similar) and whether a call failed. Connectors and MCP servers are counted as one label, never by their name. Tool inputs and results are not read.
Attachments and filesCounted only. File names and extracted text are not read.
Regenerated answers and edited promptsThe export keeps every version as a tree. Prompts, replies and tools are counted on the branch you ended on (the newest); the replaced versions are counted as branches.
Voice notesCounted only.
Chat titles and summariesNot read.
Projects, memories, design chats, account details and login historyNever opened.

The agent review (the analyze-ai-usage skill) sees only what an import keeps: your prompts and Claude's tool names, never its answers.

What chat exports cannot show

  • No model, no tokens, no cost. The export records none of them, so they are shown as not measured, never as zero and never estimated. Chats stay out of token and spend totals, out of the per-agent split in a share link and out of the leaderboard arenas built on it.
  • No coding findings. Findings, work ratios and “why sessions go wrong” come from failed commands, edits, context resets and permission prompts, which a chat does not have. Chats are left out of them, so they neither trip nor dilute them.
  • No parallel agents. Chats left open side by side are not agents working at once, so they are not counted as parallel.
  • What still counts. Activity, streaks, your hour and day of the week, words, manners, thinking, reply times and your persona include your chats. A history of only chats earns the persona Conversationalist.

Replace or remove an import

Importing a newer export replaces the earlier import whole, including conversations you have since deleted. To see or remove what is imported:

Terminal
npx ai-insights@latest import --list
npx ai-insights@latest import --remove claude

Removing deletes the imported sessions, their cached copies and any labels your agent saved for them. It never touches the export file you downloaded.

Something wrong or missing? Edit this page on GitHub or open an issue.