Supported sources

Hansard imports histories that supported tools already store on the local machine. It does not need a provider API for these sources. Coverage depends on the records each tool persists: some sources include complete messages, tool arguments, token usage, and child-agent links, while others retain only part of that data.

Use hansard help import to check the source identifiers supported by the installed version.

Import source IDs

The following identifiers can be passed to --source or --sources.

Source ID	Local history	Coverage notes
codex-cli	Codex terminal sessions	Full transcripts, tool calls, usage, diffs, and linked subagents when present.
codex-desktop	Codex desktop sessions	Uses the same state and rollout records as Codex CLI, separated by session origin.
codex-sdk	Codex exec and SDK runs	Delegated runs contribute to headline stats; one-shot batch jobs remain separately visible.
claude	Claude Code CLI	JSONL transcripts, thinking, tools, usage, Remote Control sessions, and subagents.
claude-code-desktop	Claude Code sessions launched from the Claude app	Audit transcripts are used when available; app metadata fills remaining gaps.
claude-cowork	Claude Cowork and local-agent sessions	Audit transcripts are used when available; otherwise the initial prompt and workspace metadata may be the only readable content.
claude-sdk	Claude SDK runs	Full JSONL and usage when present, with delegated and one-shot batch work separated in stats.
gemini-cli	Gemini CLI	Messages and tool counts are available, but Gemini does not persist tool arguments or shell command text.
antigravity-cli	Antigravity CLI	Readable transcripts and task artifacts when present; native token totals are unavailable.
antigravity	Antigravity 2.0 stores	Readable artifacts and trajectory summaries are imported; protobuf bodies are preserved but not decoded.
antigravity-ide	Antigravity IDE	Readable transcript and task artifacts; stale migration copies are skipped.
devin-cli	Devin for Terminal	Visible branch transcripts, tools, usage, working directories, and linked subagents.
devin-desktop	Devin Desktop	ACP event logs provide transcripts, thinking, tools, usage, and workspace metadata.
windsurf	Windsurf Cascade	Local plans are readable; matching protobuf data is preserved as raw material. Downloaded trajectories provide full transcript recovery.
copilot-cli	GitHub Copilot CLI	Session events and workspace metadata; final usage can depend on a clean session shutdown.
factory	Factory Droid	JSONL transcripts, tools, diffs, worker links, and aggregate usage sidecars.
grok-build	Grok Build	ACP update streams, workspace signals, and cumulative token data.
cursor	Cursor	Modern agent transcripts are rich; older SQLite history is imported on a best-effort basis.
pi	pi coding agent	JSONL session trees, branches, compactions, tools, token direction, and cost.
cline	Cline	API history is preferred; task and UI metadata fill gaps where necessary.
opencode-cli	OpenCode CLI	Messages, parts, tools, usage, and workspace metadata from CLI/core storage.
opencode-desktop	OpenCode Desktop	App-specific database and storage records.
opencode-web	OpenCode web sessions	Web sessions from the shared OpenCode store.
aider	Aider	Repository-local chat Markdown; model and usage data require optional LLM history.

opencode is a convenience aggregate for the CLI, Desktop, and web OpenCode sources. all selects the configured default local-source list.

Explicit imports are separate

claude-cloud, ChatGPT exports, Claude.ai exports, and downloaded Windsurf trajectories are not included in all. They must be imported with their dedicated commands.

Run an import

One source

hansard import --source cursor --since 30d

Several sources

hansard import --sources codex-cli,claude,cursor --since all

Configured sources

hansard import --source all --since all

--since accepts relative windows such as 30d, 12h, and 60m, ISO dates, or all. An explicit --sources list overrides the configured list for that run only.

Preview a backfill before writing archive files:

hansard import --source all --since all --dry-run

Ask supported importers to report why individual candidates were skipped:

hansard import --source cursor --since all --explain-skips
hansard import --source cursor --since all --explain-skips --json

Use hansard import status --json for machine-readable import state.

Source discovery and configuration

Hansard discovers standard provider locations automatically. Common examples include Codex state and rollout files, Claude Code projects, Gemini state, Cursor project transcripts and SQLite history, Cline global storage, OpenCode data, and repository-local Aider histories.

Review or change the background import list without rerunning initialization:

hansard config sources list
hansard config sources edit
hansard config sources set codex-cli,claude,cursor

sources set, add, and remove switch the watcher to an explicit list. Re-enable automatic watcher inclusion of supported local sources when desired:

hansard config set imports.autoDiscoverSources true

See the watcher for ongoing imports.

Coverage and reimports

Raw model strings and provider records remain preserved, but normalized archive metadata reflects the importer version that produced it. When hansard doctor reports parser-version drift, reimport the affected source from its original history:

hansard import --source cursor --since all

hansard rebuild is not a parser reimport. It derives viewer data from files already in the archive and does not read provider history.

A complete reimport can be the clean migration

Importer changes sometimes require --since all so every archived session is normalized under the current rules. Confirm that the provider history is still available before relying on a clean reimport.