Importer Compatibility Matrix
Generated for ai-memory-hub 1.0.1 on 2026-11-08.
Every source client has exactly one required pin. Exact release pins are used only when fixture evidence identifies that release; otherwise the pin names the bounded format, rolling-service endpoint, repository contract, or user-authored contract. A pin is not a promise that unknown future client releases are compatible.
Client pins
| Importer | Client | Pin type | Pin |
|---|---|---|---|
claude-code-session-jsonl |
Claude Code | Format version | observed-jsonl |
codex-rollout-jsonl |
Codex CLI and app | Exact client release | 0.152.0 |
copilot-activity-csv |
Microsoft Copilot | Rolling service contract | activity-history-csv |
copilot-cli-events-jsonl |
GitHub Copilot CLI | Exact client release | 1.0.88 |
deepseek-harness-session-jsonl |
DeepSeek Harness | Format version | session-format-0..4 |
deepseek-share-json |
DeepSeek web | Rolling service contract | share-content-api-v0 |
droid-exec-json |
Factory Droid | Repository-owned contract | capture-v1 |
gemini-cli-session-json |
Gemini CLI | Format version | session-object+shared-history |
hermes-session-jsonl |
Hermes Agent | Format version | sessions-export-jsonl |
manual |
Manual transcript | User-authored input | speaker-labelled-text |
opencode-session-json |
OpenCode | Format version | session-export-json |
pi-session-jsonl |
Oh My Pi | Format version | oh-my-pi-session-v3 |
pi-session-jsonl |
OpenClaw | Format version | openclaw-legacy-session-v3 |
pi-session-jsonl |
Pi | Format version | pi-session-v3 |
qwen-code-session-export |
Qwen Code | Format version | json+jsonl-export |
Latest-session discovery providers
These providers back aim import latest <source>. Each row is exercised by the linked provider-matrix test before this report is generated.
| Source | Importer | Environment override | Default root | Artifact pattern | Test |
|---|---|---|---|---|---|
claude-code |
claude-code-session-jsonl |
CLAUDE_CONFIG_DIR |
~/.claude |
projects/ |
tests/unit/test_import_discovery.py::test_discovery_provider_matrix_finds_latest_safe_artifact |
codex |
codex-rollout-jsonl |
CODEX_HOME |
~/.codex |
sessions/YYYY/MM/DD/rollout-.jsonl and archived_sessions/rollout-.jsonl | tests/unit/test_import_discovery.py::test_discovery_provider_matrix_finds_latest_safe_artifact |
copilot-cli |
copilot-cli-events-jsonl |
COPILOT_HOME |
~/.copilot |
session-state/ |
tests/unit/test_import_discovery.py::test_discovery_provider_matrix_finds_latest_safe_artifact |
oh-my-pi |
pi-session-jsonl |
PI_CODING_AGENT_DIR |
~/.omp/agent |
sessions/**/*.jsonl | tests/unit/test_import_discovery.py::test_discovery_provider_matrix_finds_latest_safe_artifact |
pi |
pi-session-jsonl |
PI_CODING_AGENT_DIR |
~/.pi/agent |
sessions/**/*.jsonl | tests/unit/test_import_discovery.py::test_discovery_provider_matrix_finds_latest_safe_artifact |
Detailed evidence
claude-code-session-jsonl
- Client pins: Claude Code -
observed-jsonl(Format version) - Artifact or command: Copy a closed top-level session JSONL file.
- Default local location: $CLAUDE_CONFIG_DIR/projects/
/*.jsonl (defaults to ~/.claude) - Contract status: Observed internal format
- Supported envelope: Observed session-scoped JSONL user and assistant message envelopes.
- Fixture evidence:
tests/fixtures/importers/claude_code_session_anonymized.jsonl - Focused tests:
tests/unit/test_importers.py::test_claude_code_session_fixture_keeps_visible_text_and_safe_provenance - Known omissions: Subagents, system prompts, thinking, tools, usage, compaction, and snapshots.
- Unknown-format fallback: Export a readable transcript and use
manual.
codex-rollout-jsonl
- Client pins: Codex CLI and app -
0.152.0(Exact client release) - Artifact or command: Copy a closed persisted rollout JSONL file.
- Default local location: $CODEX_HOME/sessions/YYYY/MM/DD/ (defaults to ~/.codex/sessions)
- Contract status: Observed internal format
- Supported envelope: Observed
session_metaplus canonical user/assistantresponse_itemmessages. - Fixture evidence:
tests/fixtures/importers/codex_rollout_anonymized.jsonl,tests/fixtures/importers/codex_rollout_rich_anonymized.jsonl - Focused tests:
tests/unit/test_importers.py::test_codex_rollout_jsonl_fixture_maps_only_canonical_messages_and_provenance,tests/unit/test_importers.py::test_codex_rollout_rich_fixture_keeps_visible_messages_only - Known omissions: Reasoning, instructions, tools, approvals, usage, startup context, and result-only streams.
- Unknown-format fallback: Create a speaker-labelled transcript and use
manual.
copilot-activity-csv
- Client pins: Microsoft Copilot -
activity-history-csv(Rolling service contract) - Artifact or command: Export all activity history from the Microsoft privacy dashboard.
- Default local location: Browser download directory; no stable local application path.
- Contract status: Documented user-facing export
- Supported envelope: CSV with exact
Conversation,Time,Author, andMessagecolumns. - Fixture evidence:
tests/fixtures/importers/copilot_activity_anonymized.csv - Focused tests:
tests/unit/test_importers.py::test_copilot_activity_csv_fixture_is_grouped_and_chronological - Known omissions: Non-conversation activity and account-specific alternate export shapes.
- Unknown-format fallback: Convert reviewed content to a speaker-labelled transcript and use
manual.
copilot-cli-events-jsonl
- Client pins: GitHub Copilot CLI -
1.0.88(Exact client release) - Artifact or command: Copy an inactive session's
events.jsonl. - Default local location: $COPILOT_HOME/session-state/
/events.jsonl (defaults to ~/.copilot) - Contract status: Observed internal format
- Supported envelope: Observed start/resume metadata and top-level message envelopes; legacy 1.0.54 is tested.
- Fixture evidence:
tests/fixtures/importers/copilot_cli_events_v1_anonymized.jsonl,tests/fixtures/importers/copilot_cli_events_resumed_anonymized.jsonl - Focused tests:
tests/unit/test_importers.py::test_copilot_cli_v1_fixture_maps_text_and_safe_provenance,tests/unit/test_importers.py::test_copilot_cli_resumed_fixture_accepts_legacy_message_envelopes - Known omissions: System/synthetic prompts, reasoning, subagents, tools, permissions, and telemetry.
- Unknown-format fallback: Use
/share file <PATH>and import the Markdown withmanual.
deepseek-harness-session-jsonl
- Client pins: DeepSeek Harness -
session-format-0..4(Format version) - Artifact or command: Download a session log, safely extract it, and select the root session JSONL.
- Default local location: Extracted
session.jsonlorsession.vN.jsonl; no stable local path. - Contract status: Documented user-facing export
- Supported envelope: Canonical Harness session formats 0 through 4.
- Fixture evidence:
tests/fixtures/importers/deepseek_harness_session_v0_descendant_anonymized.jsonl,tests/fixtures/importers/deepseek_harness_session_v4_anonymized.jsonl - Focused tests:
tests/unit/test_importers.py::test_deepseek_harness_v4_fixture_maps_text_and_safe_provenance,tests/unit/test_importers.py::test_deepseek_harness_v0_descendant_accepts_compact_messages - Known omissions: ZIPs, attachments, internal context, reasoning, tools, usage, and merged descendants.
- Unknown-format fallback: Export visible content as a speaker-labelled transcript and use
manual.
deepseek-share-json
- Client pins: DeepSeek web -
share-content-api-v0(Rolling service contract) - Artifact or command: Save one conversation's share-content response as JSON.
- Default local location: Browser download or saved API response; no stable local path.
- Contract status: Observed internal format
- Supported envelope: Successful share response with messages under
data.biz_data. - Fixture evidence:
tests/fixtures/importers/deepseek_share_anonymized.json - Focused tests:
tests/unit/test_importers.py::test_deepseek_share_json_fixture_flattens_conversational_fragments - Known omissions: Account data ZIP/JSON, search snippets, and unrelated browser-extension JSON.
- Unknown-format fallback: Create a public share response, or copy reviewed visible text into a speaker-labelled file and use
manual.
droid-exec-json
- Client pins: Factory Droid -
capture-v1(Repository-owned contract) - Artifact or command: Record
droid execin the versioned ai-memory-hub capture envelope. - Default local location: Recorder-selected path; Droid has no portable history export.
- Contract status: ai-memory-hub-defined capture
- Supported envelope: Capture version 1 with
one-shotandstream-jsonrpckinds. - Fixture evidence:
tests/fixtures/importers/droid_exec_one_shot_anonymized.json,tests/fixtures/importers/droid_exec_stream_anonymized.json - Focused tests:
tests/unit/test_importers.py::test_droid_exec_one_shot_fixture_maps_prompt_result_and_provenance,tests/unit/test_importers.py::test_droid_exec_stream_fixture_coalesces_only_completed_visible_turns - Known omissions: Raw result JSON, TUI history, share links, telemetry, and incomplete turns.
- Unknown-format fallback: Capture prompt and response in a speaker-labelled file and use
manual.
gemini-cli-session-json
- Client pins: Gemini CLI -
session-object+shared-history(Format version) - Artifact or command: Run
/chat share <FILE>or legacy/export-session <FILE>. - Default local location: User-selected export path; do not use autosaved internal JSONL.
- Contract status: Documented user-facing export
- Supported envelope: Session-object and shared-history JSON export envelopes.
- Fixture evidence:
tests/fixtures/importers/gemini_cli_export_session_anonymized.json,tests/fixtures/importers/gemini_cli_shared_history_anonymized.json - Focused tests:
tests/unit/test_importers.py::test_gemini_cli_export_session_fixture_keeps_visible_text_and_provenance,tests/unit/test_importers.py::test_gemini_cli_shared_history_fixture_excludes_injected_context_and_tools - Known omissions: Autosaved JSONL, injected context, thoughts, tools, token counts, and diagnostics.
- Unknown-format fallback: Export or copy a readable transcript and use
manual.
hermes-session-jsonl
- Client pins: Hermes Agent -
sessions-export-jsonl(Format version) - Artifact or command: Run
hermes sessions export <FILE> [--redact]. - Default local location: User-selected path; live state defaults to ~/.hermes/state.db.
- Contract status: Documented user-facing export
- Supported envelope: One complete Hermes session object per JSONL line.
- Fixture evidence:
tests/fixtures/importers/hermes_sessions_anonymized.jsonl - Focused tests:
tests/unit/test_importers.py::test_hermes_fixture_maps_live_text_and_safe_provenance,tests/unit/test_importers.py::test_hermes_multi_session_fixture_preserves_boundaries - Known omissions: Live databases, Markdown, rewound rows, synthetic context, tools, and identifiers.
- Unknown-format fallback: Use a reviewed Hermes Markdown export with
manual.
manual
- Client pins: Manual transcript -
speaker-labelled-text(User-authored input) - Artifact or command: Create UTF-8 text with supported speaker labels.
- Default local location: User-selected text file or standard input.
- Contract status: User-authored transcript
- Supported envelope: Speaker-labelled text with non-empty user and assistant messages.
- Fixture evidence:
tests/fixtures/importers/manual_transcript_synthetic.txt - Focused tests:
tests/unit/test_importers.py::test_manual_transcript_fixture_returns_unified_payload - Known omissions: Structured provenance, branches, tools, attachments, and ambiguous text.
- Unknown-format fallback: Correct the speaker labels or write a source-specific importer.
opencode-session-json
- Client pins: OpenCode -
session-export-json(Format version) - Artifact or command: Run
opencode session export <ID> --sanitize(legacy:opencode export <ID>). - Default local location: Standard output or user-selected file; do not copy internal storage.
- Contract status: Documented user-facing export
- Supported envelope: OpenCode session export JSON with
infoand ordered messages. - Fixture evidence:
tests/fixtures/importers/opencode_session_anonymized.json - Focused tests:
tests/unit/test_importers.py::test_opencode_session_json_fixture_maps_text_and_provenance - Known omissions: Internal storage, reasoning, tool-only turns, and synthetic/ignored text.
- Unknown-format fallback: Export Markdown or copy visible text and use
manual.
pi-session-jsonl
- Client pins: Pi -
pi-session-v3(Format version), Oh My Pi -oh-my-pi-session-v3(Format version), OpenClaw -openclaw-legacy-session-v3(Format version) - Artifact or command: Copy a closed version 3 JSONL tree or coordinated OpenClaw archive.
- Default local location: $PI_CODING_AGENT_DIR/sessions; OpenClaw archive location varies.
- Contract status: Observed internal format
- Supported envelope: Version 3 Pi-family trees, Oh My Pi headers, and legacy OpenClaw variants.
- Fixture evidence:
tests/fixtures/importers/pi_session_anonymized.jsonl,tests/fixtures/importers/oh_my_pi_session_anonymized.jsonl,tests/fixtures/importers/openclaw_session_anonymized.jsonl - Focused tests:
tests/unit/test_importers.py::test_pi_session_fixture_reconstructs_only_the_active_branch,tests/unit/test_importers.py::test_pi_session_detects_variants_and_omits_private_records - Known omissions: HTML, abandoned branches, live OpenClaw SQLite, thinking, tools, and usage.
- Unknown-format fallback: Export visible content as a speaker-labelled transcript and use
manual.
qwen-code-session-export
- Client pins: Qwen Code -
json+jsonl-export(Format version) - Artifact or command: Run
/export jsonor/export jsonl. - Default local location: $QWEN_HOME/projects/
/chats; export path varies. - Contract status: Documented user-facing export
- Supported envelope: Self-contained JSON, metadata-first JSONL, or bounded message-only JSONL.
- Fixture evidence:
tests/fixtures/importers/qwen_code_session_anonymized.json,tests/fixtures/importers/qwen_code_session_anonymized.jsonl - Focused tests:
tests/unit/test_importers.py::test_qwen_code_json_fixture_maps_text_and_safe_provenance,tests/unit/test_importers.py::test_qwen_code_jsonl_fixture_maps_canonical_export - Known omissions: Session listings, presentation exports, system records, tools, usage, and file lists.
- Unknown-format fallback: Use a reviewed Markdown export with
manual.