Reference

Provider history support

Provider support means importing each provider's real local history format, not normalized adapter output.

ctx provider support is specific: the CLI can discover or read a provider's real persisted local history format and index it into the local store.

Supported today

The current search CLI imports these native source formats:

Provider	Source format
Codex	`codex_session_jsonl_tree`, `codex_history_jsonl`
Pi	`pi_session_jsonl`
Claude Code	`claude_projects_jsonl_tree`
OpenCode	`opencode_sqlite`
Kilo Code	`kilo_sqlite`
Kiro CLI	`kiro_cli_sqlite`
Crush	`crush_sqlite`
Goose	`goose_sessions_sqlite`
Lingma	`lingma_sqlite`
Qoder	`qoder_transcript_jsonl_tree`
Warp	`warp_sqlite`
CodeBuddy	`codebuddy_history_json`
Trae	`trae_state_vscdb`
OpenClaw	`openclaw_session_jsonl_tree`
Hermes Agent	`hermes_state_sqlite`
NanoClaw	`nanoclaw_project`
AstrBot	`astrbot_data_v4_sqlite`
Shelley	`shelley_sqlite`
Continue	`continue_cli_sessions_json`
OpenHands	`openhands_file_events`
Antigravity	`antigravity_cli_transcript_jsonl_tree`
Gemini	`gemini_cli_chat_recording_jsonl`
Tabnine	`tabnine_cli_chat_recording_jsonl`
Cursor	`cursor_agent_transcript_jsonl_tree`
Windsurf	`windsurf_cascade_hook_transcript_jsonl_tree`
Zed	`zed_threads_sqlite`
Copilot CLI	`copilot_cli_session_events_jsonl`
Factory AI Droid	`factory_ai_droid_sessions_jsonl`
Qwen Code	`qwen_code_chat_jsonl_tree`
Kimi Code CLI	`kimi_code_cli_wire_jsonl_tree`
Auggie	`auggie_session_json`
Junie	`junie_session_events_jsonl_tree`
Firebender	`firebender_chat_history_sqlite`
ForgeCode	`forgecode_sqlite`
Deep Agents	`deepagents_sessions_sqlite`
Mistral Vibe	`mistral_vibe_session_jsonl_tree`
Mux	`mux_session_jsonl_tree`
Rovo Dev	`rovodev_session_json_tree`
Cline	`cline_task_directory_json`
Roo Code	`roo_task_directory_json`

Use ctx sources for the truth on the current machine:

ctx sources
ctx sources --json

In JSON output, native_import: true means ctx has parser support for that provider format. importable: true means the current path exists, has supported data, and can be imported on this machine. Source status can be available, empty, unknown, missing, or unsupported.

CLI provider flags include codex, pi, claude, opencode, kilo, kiro-cli, crush, goose, lingma, qoder, warp, codebuddy, trae, openclaw, hermes, nanoclaw, astrbot, shelley, continue, openhands, antigravity, gemini, tabnine, cursor, windsurf, zed, copilot-cli, factory-ai-droid, qwen-code, kimi-code-cli, auggie, junie, firebender, forgecode, deepagents, mistral-vibe, mux, rovodev, cline, and roo. JSON and SQL output use provider IDs in ctx output; multiword IDs may appear as snake case, such as copilot_cli or factory_ai_droid.

NanoClaw is explicit-import only. Use ctx import --provider nanoclaw when discovery finds the desired source, or add --path to target a project root.

What support means

Provider support means ctx can discover or read a provider's persisted local history format. It does not mean ctx launches that agent, installs that agent, or guarantees every provider-specific field is normalized into the same shape.

Custom formats

For an agent history format ctx does not support natively, use a custom history plugin. A plugin is a local manifest plus a local command that streams normalized history records to ctx.

Import rules

Provider imports must be read-only with respect to provider-owned files, explicit through ctx import, ctx setup, or the bounded ctx search --refresh auto native-source refresh path, safe to interrupt and re-run, conservative around unknown schemas, and clear about source citations.