dsh-chat-import README

The project's README from github.com/Nwflower/dsh-chat-import. As one markdown file: README.md.

DSH Chat Import

DSH Chat Import

A DeepSeek Harness plugin that imports conversation history from 18+ AI coding tools, so you can continue right where you left off.

All sessions, continued in DSH.

English 简体中文

version downloads GitHub stars GitCode license Awesome DSH Plugin dsh.so install

Intro

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

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

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

Supported Agents
Claude Code
Claude Code		 Codex
Codex		 ChatGPT
ChatGPT		 Cursor
Cursor		 Gemini
Gemini CLI
Reasonix
Reasonix		 OpenCode
OpenCode		 MiMo Code
MiMo Code		 Kilo Code
Kilo Code		 ZCode
ZCode
Grok Build
Grok Build		 OpenClaw
OpenClaw		 Pi Coding Agent
Pi Coding Agent		 Hermes
Hermes		 Kimi CLI
Kimi CLI
Qoder CLI
Qoder CLI		 WorkBuddy
WorkBuddy		 Qwen Work CN
Qwen Work CN		 DSH
DSH

Install

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

Usage

  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.

  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.

  3. Tool injection (optional) — the "Session Import" settings section exposes three injectTools levels: Minimal (default, keeps only the import_chat entry tool resident; low-frequency management tools stay out of context), Full (all 13 tools), and Off (invisible to the agent; the GUI panel still works). Tool descriptions are slimmed down to selection-time essentials; behavioral details ride along in execution results and error text, only when needed.

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 -- DSH 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 DSH skills); for full config migration (hooks, permission rules, settings), use dsh-movein.

Features

Capability Entry points Description
Batch import import_chat (20 formats) · scan_discover · sidebar panel Import 19+ 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 DSH sessions back to Claude / Codex / Kimi
Bidirectional sync panel "Sync" tab Incremental sync in both directions (external ↔ DSH), off by default

One documented exception to full fidelity: failed ghost retry steps. When a tool call never received its result and the very next step re-emits the same call id verbatim, the dead step is dropped at import — the result already pairs with the re-emitted call. Duplicate call ids in the imported log would hard-fail DSH's conversation folding (a second start for the same id), swallowing the whole trajectory after the first duplicate. See the droppedRetrySteps counter on the converter result.

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

Star History Chart

dsh-chat-import (Nwflower/dsh-chat-import)

Searching Database…

238 ·GitHub
Dsh-chat-import
这是什么？DSH Chat Import 是一个 DeepSeek Harness（DSH）插件，可以把 25 种以上 AI 编程 agent（Claude Code、Codex、Cursor、Gemini、ChatGPT 等）的对话历史导入 DSH，成为可完整恢复的会话，并完整保留工具调用、推理过程和结果。
这是独立应用，还是需要 DeepSeek Harness？它是运行在 DeepSeek Harness（DSH）内部的插件，不是独立应用——它在 DSH GUI 中添加了一个侧边栏面板和一组可调用工具（importchat、exportchat、scandiscover）。
怎么导入我的旧对话？在 DSH GUI 右下角打开“Import sessions”面板，选择你想要的对话，一键导入——或者让你的 agent 直接调用 importchat 工具。
除了 DeepSeek Harness 本身还需要什么？你需要安装 DeepSeek Harness（插件运行在它内部）以及 Node.js 22.13 或更新版本，因为这是一个基于 Node 的插件。
每段对话都能 100% 保真地导入吗？几乎是——唯一有记录的例外是“幽灵重试”步骤：如果某个工具调用始终没有得到结果，而下一步又重新发出了相同的调用 id，这个失效步骤会在导入时被丢弃，以避免 DSH 的会话折叠出现硬性错误。
能把 DSH 会话导出回原来的工具吗？可以——exportchat 工具能把 DSH 会话序列化回 Claude Code、Codex 或 Kimi Code 格式。
导入的会话能与原始来源保持同步吗？可以，面板的“Sync”标签页提供外部工具与 DSH 之间可选的双向增量同步，但默认是关闭的。
injectTools 的各个级别有什么作用？它们控制插件的工具集对 agent 的可见程度：Minimal（默认）只在上下文中保留入口工具，Full 暴露全部 13 个工具，Off 则完全隐藏它们，但 GUI 面板仍可正常工作。
它也能迁移我的 agent 配置和技能吗？只是轻量支持——它可以通过 importagents 把 agents/prompts/skills 保存为 DSH 技能，但完整的配置迁移（钩子、权限规则、设置）由配套工具 dsh-movein 处理。
What are similar projects?operator-memory, dsh-crew, pi2dsh, 9router, dsh-plugin-bridge, dsh-routing-suite, dsh-synapse, dsh-our-free-model
Which topics is it in?sessions, transcript, migration, dsh, dsh-plugin, deepseek-harness, chatgpt, ci, cursor, deepseek, gemini, plugin
Creator
Nwflower
Size
4.5 MB
Stars
238
Updated
CommitOct 19Releasev0.26.1Oct 17
Age
2mo
Commits · 90 Days