Intro

ChatCode CLI Chat Import imports conversation history with full context from other agents, turning it into a seamlessly resumable ChatCode CLI session.

Now covers import from 19 agents: Claude Code, Codex, ChatGPT, Cursor, Gemini, Reasonix, opencode, MiMo Code, ZCode, Grok Build, OpenClaw, Pi Coding Agent, Hermes, Kimi CLI / Kimi Code, Qoder CLI, WorkBuddy, Qwen Work CN (千问办公), and legacy DSH session logs.

Export back to: Claude Code, Codex, Kimi Code.

Install

chatcode-cli plugin --profile web add @chatcode/cco-chat-import          # npm package
chatcode-cli plugin --profile web add -w link:/path/to/dsh-chat-import   # local checkout (symlink)

Usage

Startup auto import

On the first ChatCode CLI startup after installing the plugin, existing ChatCode CLI history is scanned and imported automatically. The lower-left sidebar shows the scan state, then completed / total while importing, followed by the total, successful, failed, and skipped counts for five seconds. Later startups do not rescan when imports.json already exists.

1. Import — pick the conversations to import from the "Import sessions" panel in the bottom-right of the GUI and import with one click, or have your agent call the context tool:

import_chat({ format: "claude", path: "~/.claude/projects" })
import_chat({ format: "chatgpt", path: "~/Downloads/chatgpt-export/conversations.json" })
import_chat({ format: "local-jsonl", path: "D:\downloads\session.jsonl" })

Reasonix directory imports conservatively collapse only recovery ancestors proven by both a strict semantic prefix and an explicit parent_id lineage. Ambiguous or divergent files remain separate; use lineageMode: "physical" for one session per JSONL.

Claude Code imports exclude complete, known CLI-injected tag-wrapped records (such as command context and system reminders) from user turns.

1. Resume — refresh the session list, open the imported session, and keep chatting from where the source left off.

2. Sync (optional) — the panel's "Sync" tab offers bidirectional incremental sync, off by default. Sub-agent conversations are filtered out by default in both directions.

Full tool / command usage (parameters, examples, edge cases) lives in docs/USAGE.md.

Companion tool: config migration

Only need to migrate configuration (skills, hooks, global settings) rather than conversation history? dsh-movein handles config migration and complements this plugin -- ChatCode CLI Chat Import only handles conversation history, and each tool works standalone. Its first-migration guide (中文) walks through a preview-first, apply-second, verify-each-step flow.

The combined flow of the two tools has not been jointly validated, and cross-linking is not a mutual endorsement; check sources, targets, duplicate-import and retraction boundaries for each tool separately.

This plugin's import_agents is a lightweight asset mover (it persists pi/opencode/Claude/Codex agents, prompts and skills as ChatCode CLI skills); for full config migration (hooks, permission rules, settings), use dsh-movein.

Features

Capability	Entry points	Description
Batch import	import_chat (19 formats) · scan_discover · sidebar panel	Import 18+ sources with one tool; each conversation becomes its own session
Import history & purge	sidebar panel History tab	View imports.json records; remove plugin-created sessions (with confirmation)
Full-fidelity resume	Imported sessions	Tool calls & results, reasoning, titles, models and timestamps carry over
Export back	export_chat (format: claude / codex / kimi)	Serialize ChatCode CLI sessions back to Claude / Codex / Kimi
Bidirectional sync	panel "Sync" tab	Incremental sync in both directions (external ↔ ChatCode CLI), off by default

Docs

Document	Description
Usage Reference	Full parameters, examples and edge cases for every tool / command
Interchange protocol	Interchange v1 protocol and bundle format
Changelog	Version history
Roadmap	Shipped / planned
Contributing	Development setup, commit rules, security & privacy

Star History