# Hansard

> Hansard is a local-first memory layer for AI coding agents. It archives conversations and memory files from Claude Code, Codex, Cursor, GitHub Copilot, Antigravity, and dozens of other coding agents, plus ChatGPT, Claude.ai, and Gemini exports, into one searchable archive on your computer. Your agents can search and cite that history through its MCP server.

- Install the CLI with `npm install -g hansard` (Node.js 20 or newer), or download the desktop app for macOS and Windows.
- Free to use under the MIT license. Needs no account; the archive stays in `~/.hansard` on your computer.
- Importing, search, Stats, memories, and the app run on your computer. Work classification, on by default, sends a digest of each finished conversation to the Claude or Codex CLI you are signed in to; Personal Sync, Teams, Slack, and Deep Recall send data only when you use them. The page What leaves your machine lists every case.

## What Hansard does

- Archive and back up AI coding agent conversation history from Claude Code, Codex, Cursor, GitHub Copilot, Antigravity, Aider, Cline, OpenCode, Devin, and dozens more
- Import ChatGPT, Claude.ai, and Gemini data exports into the same archive
- Search every past agent conversation by text, project, harness, model, tool, shell command, edited file, or git commit
- Agent memory management: back up, version, search, and edit CLAUDE.md, AGENTS.md, Codex memories, and other agent memory files
- Recall for coding agents: an MCP server and skills that let Claude Code, Codex, Cursor, and other agents search past conversations and memories
- Deep Recall: answers to broad questions about your history, built from several searches with session citations
- Token usage, estimated cost, model, and tool statistics across every coding agent
- Continue a conversation in another harness or model, and fork or resume archived sessions
- Messaging and helper agents between live coding agent sessions, with project coordinators
- A knowledge graph of projects and conversations connected by files, commits, and topics
- Personal Sync across your computers, Teams sharing by repository, and Slack recaps
- A desktop app for macOS and Windows, a browser viewer, and a CLI that share one archive

## Questions and the pages that answer them

- [How do I search my past Claude Code, Codex, and Cursor conversations?](https://www.hansard.dev/guides/search.md): Hansard imports the history of every coding agent on your computer into one archive and searches all of it at once.
- [Which agent conversation wrote this line of code?](https://www.hansard.dev/guides/search.md): Run `hansard why <file>:<line>`, such as `hansard why src/server/auth.ts:120`.
- [How do I manage memory files like CLAUDE.md and AGENTS.md across agents?](https://www.hansard.dev/guides/memories.md): Hansard backs up the memory and instruction files your agents keep, such as `CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, Codex memories, and Cursor memories and user rules.
- [How do I give my coding agent memory of earlier conversations?](https://www.hansard.dev/guides/agent-integrations.md): Install recall, which connects the agent to Hansard's MCP server.
- [How do I keep Claude Code from deleting my conversation history?](https://www.hansard.dev/imports/watcher.md): Claude Code deletes CLI transcripts older than 30 days by default, controlled by `cleanupPeriodDays`.
- [How do I back up or export my coding agent chat history?](https://www.hansard.dev/guides/browse-conversations.md): The archive is a backup: it keeps each conversation as a readable transcript plus a copy of every original file the harness wrote.
- [How do I import my ChatGPT, Claude.ai, and Gemini conversations?](https://www.hansard.dev/imports/web-exports.md): Request a data export from the service, then import the file it sends you.
- [How do I track token usage and cost across Claude Code, Codex, and Cursor?](https://www.hansard.dev/guides/stats.md): **Stats** totals conversations, messages, tokens, and estimated spend at API prices across every harness and model, for any time range.
- [How do I continue a Claude Code conversation in Codex or another agent?](https://www.hansard.dev/guides/continue.md): Open the conversation in **Sessions**, choose **Continue in…**, and pick an installed harness.
- [Can coding agents in the same project message each other?](https://www.hansard.dev/guides/session-messaging.md): Yes. Live Codex and Claude Code sessions with Hansard's tools, working in the same project, can find each other and exchange notes and questions.
- [How do I give a project a long-running coordinator agent?](https://www.hansard.dev/guides/projects.md): Open the project's overview in the app and start its coordinator: a persistent Codex or Claude Code conversation that keeps the project's goals and hands work to helper agents.
- [How do I answer broad questions about past work with agents?](https://www.hansard.dev/guides/deep-recall.md): Deep Recall plans several searches, reads the strongest conversations in full, and writes an answer that cites each one.
- [How do I sync coding agent history between my computers?](https://www.hansard.dev/sync/personal-sync.md): Personal Sync backs up your whole archive to a bucket or shared folder you own and brings each device's conversations into every installation.
- [How do I share agent conversations with my team?](https://www.hansard.dev/sync/teams.md): A Team shares whole conversations from chosen repositories through a bucket or shared folder your team controls.
- [Which skills, plugins, and MCP servers does each agent have installed?](https://www.hansard.dev/guides/skills-and-mcps.md): The **Skills & plugins** view lists the skills, plugins, MCP servers, and connectors every harness on your computer has configured, with earlier versions of each skill.
- [How do I reduce Claude Code permission prompts?](https://www.hansard.dev/guides/permissions.md): Run `hansard permissions suggest` in your project folder. It replays the shell commands your agents ran against your Claude Code `Bash(...)` allow rules and suggests rules for the frequent commands they miss.
- [How do I track plan limits across several Claude and Codex accounts?](https://www.hansard.dev/guides/account-authentication.md): The **Accounts** view keeps your agent and browser accounts in one place, shows how much of each plan's limits you have used, and can choose which account a new session uses.
- [How do I see how my projects and conversations connect?](https://www.hansard.dev/guides/graph.md): **Graph** draws your archive as a network of projects and conversations, linked by shared files, commits, continuations, and agent messages.
- [Which coding agents does Hansard support?](https://www.hansard.dev/imports/supported-sources.md): Hansard imports Claude Code, Codex, Cursor, GitHub Copilot, Antigravity, Aider, Cline, Roo Code, Kilo Code, OpenCode, Goose, Amp, Zed, Warp, Kiro, Devin, Factory Droid, Jules, Grok Build, and more, plus ChatGPT, Claude.ai, and Gemini exports.
- [Does Hansard send my conversations anywhere?](https://www.hansard.dev/privacy/data-boundaries.md): Importing, search, Stats, memories, and the app run on your computer without a Hansard account.
- [Is Hansard free?](https://www.hansard.dev/getting-started/installation.md): Yes. The CLI installs from npm with `npm install -g hansard` under the MIT license, and the desktop app for macOS and Windows is a free download.

## Get started

- [What is Hansard](https://www.hansard.dev/getting-started/introduction.md): Hansard keeps one local, searchable archive of your coding-agent conversations and memories, and makes it available to your agents.
- [Use cases](https://www.hansard.dev/getting-started/use-cases.md): Questions developers ask about coding agent history, memory files, recall, usage, and multi-agent work, with the Hansard feature that answers each one.
- [Install the app](https://www.hansard.dev/getting-started/download.md): Download Hansard for macOS or Windows and set up your archive without a terminal.
- [Install the CLI](https://www.hansard.dev/getting-started/installation.md): Install the hansard command with npm, run setup, and confirm that your archive and watcher are working.
- [Set up with an agent](https://www.hansard.dev/getting-started/agent-setup.md): Paste one prompt into a coding agent to install Hansard, import your history, and connect recall, then check the result.
- [Quickstart](https://www.hansard.dev/getting-started/quickstart.md): Import your agent history, find and open a past conversation, and give your agents recall of earlier work.
- [How Hansard works](https://www.hansard.dev/getting-started/how-it-works.md): How Hansard turns agent history into one local archive, keeps it current, and makes it available to the app, the CLI, and your agents.

## Your archive

- [Browse conversations](https://www.hansard.dev/guides/browse-conversations.md): Read archived Claude Code, Codex, and Cursor conversations with tool calls, diffs, subagents, files, and terminals, and export or delete one conversation.
- [Search](https://www.hansard.dev/guides/search.md): Find past Claude Code, Codex, Cursor, and other agent conversations by text, harness, model, folder, tool, shell command, edited file, or git commit.
- [Deep Recall](https://www.hansard.dev/guides/deep-recall.md): Ask broad questions about your history and get an answer built from several searches and whole conversations, with session citations.
- [Memories](https://www.hansard.dev/guides/memories.md): Back up, version, search, and edit coding agent memory files such as CLAUDE.md, AGENTS.md, and Codex memories, and let agents search each other's memories.
- [Graph](https://www.hansard.dev/guides/graph.md): Explore how your projects and conversations connect through shared files, commits, agent messages, continuations, and topics.

## Your agents

- [Recall in your agents](https://www.hansard.dev/guides/agent-integrations.md): Install Hansard's MCP server and recall skills so Claude Code, Codex, Cursor, and other agents can search your past conversations and memories.
- [Continue in another harness](https://www.hansard.dev/guides/continue.md): Continue archived conversations in another coding harness, resume or fork them, run agents on your other computers, and recover from usage limits.
- [Agent messaging](https://www.hansard.dev/guides/session-messaging.md): Let live Claude Code, Codex, and other agent sessions in the same project find each other and exchange notes, questions, and answers.
- [Helper agents](https://www.hansard.dev/guides/agent-delegation.md): Let a supported live agent session start helper agents in local harnesses, steer them, and collect their results.
- [Projects and coordinators](https://www.hansard.dev/guides/projects.md): Open a project's overview, compare projects, and give a project a persistent Codex or Claude Code coordinator that delegates work to helpers.
- [Skills, plugins, and MCP servers](https://www.hansard.dev/guides/skills-and-mcps.md): See the skills, plugins, MCP servers, and connectors each harness has configured on this device, and follow how your skills change over time.
- [Harness settings](https://www.hansard.dev/guides/harness-settings.md): Compare memory, history cleanup, model, and permission settings across the agent harnesses on this device.
- [Permission suggestions](https://www.hansard.dev/guides/permissions.md): Find the shell commands your agents run most often that Claude Code still asks about, and get Bash allow rules to cover them.
- [Dictation](https://www.hansard.dev/guides/dictation.md): Speak messages into the conversation composer and choose the engine that turns speech into text.

## Insights

- [Stats](https://www.hansard.dev/guides/stats.md): See conversations, messages, token usage, estimated spend, models, tools, and projects across Claude Code, Codex, Cursor, and every other harness.
- [Compare periods](https://www.hansard.dev/guides/behavior.md): Compare how you worked with agents in one period against the equally long period right before it, in the Stats Changes tab or from the CLI.
- [Work classification](https://www.hansard.dev/guides/classification.md): Label archived conversations by work mode, outcome, and task profile so Stats can show what you worked on, how it went, and how that changed.
- [Accounts and plan usage](https://www.hansard.dev/guides/account-authentication.md): Save agent and browser accounts, track plan limits, and choose which account each new session or request uses.

## Import history

- [Supported harnesses](https://www.hansard.dev/imports/supported-sources.md): See which coding agents Hansard imports, find each source ID and harness guide, and import your history from the app or the CLI.
- [Background archiving](https://www.hansard.dev/imports/watcher.md): Keep your archive current with the watcher, a background process that imports new sessions from your local harnesses as you work.
- [ChatGPT, Claude.ai, and Gemini exports](https://www.hansard.dev/imports/web-exports.md): Import conversation exports from ChatGPT, Claude.ai, and Gemini into your archive, in the app or from the CLI.
- [Browser conversation capture](https://www.hansard.dev/imports/browser-capture.md): Capture signed-in ChatGPT, Claude.ai, Gemini, Perplexity, Devin, and Ask Devin history with the preview Hansard Browser extension.

## Harness guides

- [Aider](https://www.hansard.dev/imports/aider.md): Import Aider chat histories from your repositories, with model, token, and commit details when Aider saved them.
- [Antigravity](https://www.hansard.dev/imports/antigravity.md): Import Antigravity CLI, Antigravity 2.0, and Antigravity IDE history, including tool calls and token usage where Antigravity saved them.
- [Claude](https://www.hansard.dev/imports/claude.md): Import Claude Code CLI, desktop, Cowork, and Agent SDK sessions, and Claude Code cloud and Remote Control sessions on request.
- [Cline](https://www.hansard.dev/imports/cline.md): Import Cline task history from VS Code and JetBrains, and Cline CLI, desktop, and SDK sessions, as two separate sources.
- [CodeBuddy](https://www.hansard.dev/imports/codebuddy.md): Import CodeBuddy Code project transcripts. Hansard counts and keeps any record types it does not recognize.
- [Codex](https://www.hansard.dev/imports/codex.md): Import Codex CLI, Codex desktop app, and Codex SDK sessions, and Codex cloud tasks on request.
- [Crush](https://www.hansard.dev/imports/crush.md): Import Crush project conversations, reasoning, tools, attachments, and child sessions.
- [Goose](https://www.hansard.dev/imports/goose.md): Import Goose CLI, desktop, and API sessions, tools, reasoning, and usage.
- [Continue](https://www.hansard.dev/imports/continue.md): Import Continue IDE and CLI conversations, tool calls, reasoning, context, and usage.
- [Amp](https://www.hansard.dev/imports/amp.md): Import Amp local thread history, JSON exports, app conversations, and hosted orb threads.
- [Zed](https://www.hansard.dev/imports/zed.md): Import Zed Agent Panel conversations, historical text threads, and local instructions.
- [OpenHands](https://www.hansard.dev/imports/openhands.md): Import OpenHands CLI, SDK, Agent Canvas, legacy application, and cloud conversation history.
- [Junie](https://www.hansard.dev/imports/junie.md): Import JetBrains Junie CLI sessions, IDE task chains, instructions, and project memory.
- [Roomote](https://www.hansard.dev/imports/roomote.md): Import Roomote server histories through a read-only database history copy or authorized cloud endpoints.
- [MiniMax Code](https://www.hansard.dev/imports/minimax-code.md): Import MiniMax Code CLI, desktop, and cloud histories and Markdown memories.
- [TRAE](https://www.hansard.dev/imports/trae.md): Import Trae Agent, legacy IDE, TraeCode, and TraeWork histories and memories.
- [Qoder](https://www.hansard.dev/imports/qoder.md): Import Qoder CLI, app, IDE, Work, and Cloud Agents histories and memories.
- [Augment](https://www.hansard.dev/imports/augment.md): Import Auggie CLI, Augment IDE, Cosmos sessions, instructions, and local memories.
- [Kiro](https://www.hansard.dev/imports/kiro.md): Import Kiro CLI, IDE, Crew, native exports, instructions, and memories.
- [Warp](https://www.hansard.dev/imports/warp.md): Import Warp desktop, Agent CLI, legacy AI blocks, Oz runs, and local instructions.
- [OpenClaw](https://www.hansard.dev/imports/openclaw.md): Import OpenClaw Gateway conversations, tool activity, model usage, and workspace memories.
- [Hermes](https://www.hansard.dev/imports/hermes.md): Import Hermes profile conversations, tool activity, model usage, and persistent memory.
- [DeepSeek Harness](https://www.hansard.dev/imports/deepseek-harness.md): Import local DeepSeek Harness session logs, tool activity, attachments, and instructions.
- [Kilo Code](https://www.hansard.dev/imports/kilo-code.md): Import Kilo Code CLI, IDE, legacy task, and cloud histories with tools, usage, and memory files.
- [Roo Code](https://www.hansard.dev/imports/roo-code.md): Import historical Roo Code IDE and CLI tasks, tools, usage, and instruction files.
- [GitHub Copilot](https://www.hansard.dev/imports/copilot.md): Import GitHub Copilot CLI sessions, Copilot Chat from VS Code-family editors, and Copilot coding agent sessions on request.
- [Cursor](https://www.hansard.dev/imports/cursor.md): Import Cursor CLI conversations, Cursor app agent transcripts and older Cursor history from its local databases, and Cursor cloud agents on request.
- [Devin](https://www.hansard.dev/imports/devin.md): Import Devin for Terminal and Devin Desktop sessions, and Devin cloud sessions from the browser extension or the Devin API.
- [Factory Droid](https://www.hansard.dev/imports/factory.md): Import local Factory Droid sessions, and Factory cloud sessions on request.
- [Gemini CLI](https://www.hansard.dev/imports/gemini-cli.md): Gemini CLI is retired. Import the saved chats, checkpoints, and prompt logs it left on your machine.
- [Gemini Notebook / NotebookLM](https://www.hansard.dev/imports/notebooklm.md): Import NotebookLM Takeout chat history and preserve notebook resources separately.
- [Grok Build](https://www.hansard.dev/imports/grok-build.md): Import Grok Build sessions with their tool calls, token usage, cost, and forks.
- [iFlow](https://www.hansard.dev/imports/iflow.md): Import iFlow CLI project transcripts, including tool calls and the history from before each context compaction.
- [Jules](https://www.hansard.dev/imports/jules.md): Import Jules sessions from the Jules API. Jules keeps no local history, so the import runs when you ask for it or turn it on in Settings.
- [Kimi](https://www.hansard.dev/imports/kimi.md): Import Kimi Code and Kimi CLI sessions from their session journals, with subagents as linked conversations.
- [MiMo Code](https://www.hansard.dev/imports/mimo-code.md): Import MiMo Code sessions from its local SQLite database, without copying account or credential data.
- [Muse Code](https://www.hansard.dev/imports/muse-code.md): Import Muse Code sessions with their titles, models, tool calls, token usage, and linked subagent runs.
- [Posit Assistant](https://www.hansard.dev/imports/posit-assistant.md): Import Posit Assistant local conversation trees with recorded reply models, usage, and tools.
- [gptme](https://www.hansard.dev/imports/gptme.md): Import gptme local conversation logs with recorded reply metadata and preserved branches.
- [OpenCode](https://www.hansard.dev/imports/opencode.md): Import OpenCode CLI, desktop, and web sessions from OpenCode's local history, without copying credentials or share secrets.
- [pi](https://www.hansard.dev/imports/pi.md): Import pi coding agent sessions along the branch you last worked on, with tool calls, token usage, and estimated cost.
- [Prime Agent](https://www.hansard.dev/imports/prime-agent.md): Import Prime Agent sessions, forks, and recursive child sessions. Hansard never reads Prime Agent credentials.
- [Qwen Code](https://www.hansard.dev/imports/qwen-code.md): Import Qwen Code chats, tool results, images, checkpoints, prompt logs, and subagent sessions.
- [Mistral Vibe](https://www.hansard.dev/imports/vibe.md): Import Mistral Vibe sessions in both of Vibe's session formats, with token, price, and subagent details.
- [Windsurf](https://www.hansard.dev/imports/windsurf.md): Windsurf is retired. Import the Cascade history it left on your machine, and recover full transcripts from downloaded trajectories.

## Sync and share

- [Personal Sync](https://www.hansard.dev/sync/personal-sync.md): Back up your complete Hansard archive to storage you control and keep your own devices in step.
- [Teams](https://www.hansard.dev/sync/teams.md): Share whole conversations from selected repositories with teammates through storage your team controls.
- [Slack](https://www.hansard.dev/sync/slack.md): Post conversation recaps, live conversation threads, and a daily digest to Slack channels you choose.
- [Hosted viewer](https://www.hansard.dev/sync/hosted-viewer.md): Serve the Hansard app to other devices on a trusted network, with a password and read-only access.

## Privacy

- [What leaves your machine](https://www.hansard.dev/privacy/data-boundaries.md): Every Hansard feature that sends data off this machine, what it sends, and how to turn it on or off.
- [Redaction](https://www.hansard.dev/privacy/redaction.md): Replace known secret patterns in archived conversation text, preview rules, and understand what redaction does not cover.
- [Browser extension privacy](https://www.hansard.dev/privacy/browser-extension.md): What the Hansard browser extension reads, where it sends it, and what it never collects or shares.

## Reference

- [Provider and feature support](https://www.hansard.dev/reference/provider-support.md): Compare archive imports, memory capture and retrieval, MCP tools, agent launches, model selection, and account routing across every supported harness.
- [Import coverage by company and product](https://www.hansard.dev/reference/import-coverage.md): Compare exact import routes, product boundaries, verification gaps, and unsupported harnesses.
- [CLI commands](https://www.hansard.dev/reference/cli.md): Every top-level hansard command, grouped by task, with a link to the guide that covers it.
- [Configuration](https://www.hansard.dev/reference/configuration.md): Change Hansard's settings in the app or with hansard config, and look up common keys and environment variables.
- [Keyboard shortcuts](https://www.hansard.dev/reference/keyboard-shortcuts.md): Default keyboard shortcuts in the Hansard app and how to change them.
- [Archive layout](https://www.hansard.dev/reference/archive-layout.md): Where Hansard stores conversations, original files, attachments, memories, and indexes, and which version fields control rebuilds.
- [Maintenance](https://www.hansard.dev/reference/maintenance.md): Check Hansard's health, refresh the right part of the archive, recover lost harness files, reclaim space, and upgrade safely.
- [Troubleshooting](https://www.hansard.dev/reference/troubleshooting.md): Fix missing conversations, late imports, empty search results, app launch problems, export imports, and stuck syncs.

## Optional

- [Release notes](https://www.hansard.dev/releases/)
- [Upgrade notes](https://www.hansard.dev/releases/upgrading/)
- [npm package](https://www.npmjs.com/package/hansard)
- [Prime Agent model catalog](https://www.hansard.dev/reference/prime-agent-models.md): Complete provider and model inventory bundled with the audited Prime Agent release.
- [Complete documentation in one file](https://www.hansard.dev/llms-full.txt)