Introduction

When developing with DSH / agents, a common scenario is: historical sessions already exist in tools like claude-code, codex, reasonix, zcode, etc., but when wanting to continue the same project in DSH, you need to reorganize the context.

dsh-plugin-session-import solves this migration problem: it imports the historical chat records from the above tools as DSH sessions, along with workspace bindings and tool capabilities. After importing, you can continue the conversation directly.

What Is This

dsh-plugin-session-import is a DeepSeek Harness plugin maintained by huguangyu666, licensed under MIT.

It is designed for developers who already have local session records, converting chat histories from claude-code / codex / reasonix / zcode into sessions that DSH can continue using.

Core Features

Session Import

  • Supports parsing from four tools: claude-code, codex, reasonix, and zcode.
  • Imports historical chat records as DSH sessions, including workspace bindings and tool capabilities.
  • After import, you can continue the conversation directly.
  • Session list displays title, project name, message count, and time.
  • Scanning uses a 30-second cache.
  • Filter and search by title / project name, with input debouncing.

Batch Import

  • Supports multi-select sessions for import at once.
  • Each session has an independent seed + workspace binding.

Tool Capabilities

  • Imported sessions automatically join the default preset scope.
  • Over 25 tools are available, such as read / edit / glob / grep / pwsh, etc., consistent with normal sessions.

Oversized Session Protection

  • Executes in order: content trimming → message truncation → single message fallback.
  • DSH_IMPORT_CONTEXT_BUDGET can override the budget.

Web UI and Commands

  • Web UI sidebar provides an “⇩ Import Session” button, adaptive to light and dark themes.
  • Command line supports:
/import <tool> <path>

Both files and directories can be passed; directories indicate batch processing.

Installation and Activation

First, check the runtime environment:

node >=22.5

Plugin declared dependency versions:

@deepseek-ai/dsh >=0.1.0-rc.6
@deepseek-ai/dsh-client-locale >=0.1.0-rc.6
react >=18.0.0

Use the official commands to install:

dsh plugin --profile web add dsh-plugin-session-import
dsh web

The first command adds the plugin to the web profile, and the second command restarts to take effect.

You can also use the store method:

  1. Install dsh-store.
  2. Open “Plugin Store” to search and install.

Typical Usage

Web UI Import

  1. Click “⇩ Import Session” at the bottom of the sidebar.
  2. Select the tool.
  3. Search / scroll for batch loading.
  4. Check the sessions.
  5. Import.

Command Line Import

Example:

/import codex C:\Users\xxx\.codex\sessions

When passing a directory, it is processed as a batch.

Use Cases and Notes

Suitable for developers who already have local sessions from claude-code, codex, reasonix, zcode and wish to continue subsequent tasks in DSH.

Before use, note the following:

  • Image attachments will be downgraded to placeholder text; some tools do not support image blocks.
  • Truncated historical messages in oversized sessions are not retained; summaries and anchors are kept.
  • Some session titles in reasonix desktop version rely on .titles.json; if missing, it falls back to filename extraction.
  • The plugin runs with the current DSH process permissions. It is recommended to check the source code and license before installation.
  • License is MIT.

Conclusion

After following the above steps, you can import local tool historical sessions into DSH and continue tasks within the imported sessions.

GitHub repository:

https://github.com/huguangyu666/dsh-plugin-session-import

Directory page from plugin reference:

https://www.skillhub.cn/plugins/huguangyu666/dsh-plugin-session-import