Introduction

When developing DSH-related projects, if there is a batch of Codex sessions locally and you want to bring this history into DSH for further processing, a common approach is manual export and paste, which easily leads to context loss. Below, I introduce the dsh-codex plugin maintained by life1996cou: it reads sessions from the local Codex session directory and generates a new DSH session with a complete conversation history.

What is this

  • Plugin repo: life1996cou/dsh-codex
  • License: MIT
  • One-sentence positioning: Import sessions from local Codex (~/.codex/) and generate a new DeepSeek Harness session with a complete conversation history.
  • Platform declaration: dsh.client.platform in package.json is web, and @deepseek-ai/dsh-client-runtime and @deepseek-ai/dsh-api-gateway are injected.

Core Features

The following verified capabilities are listed:

  • Import sessions from local Codex (~/.codex/)
  • Generate a new DeepSeek Harness session with a complete conversation history
  • Support configuring the Codex session directory in settings
  • Support clicking “Import to New Session” from the session list and switching to it

Installation and Activation

First, install the plugin:

dsh plugin --profile web add github:life1996cou/dsh-codex

Then start the DSH Web client:

dsh web

If installing using a local directory, the documentation suggests using file: for a copy installation to avoid using bare paths:

dsh plugin --profile web add file:.

The reason is that bare paths create symlinks, which leads to dependency resolution failures.

Typical Usage

  1. Open DSH Web settings.
  2. Click “Codex” on the left side of the settings page.
  3. Select “Use default ~/.codex/sessions” or click “Select directory…” to locate the Codex session directory.
  4. Find the target session in the session list and click “Import to New Session”.
  5. The plugin will generate a new session containing the complete Codex conversation history and automatically switch to that session.

Uninstallation and Name Explanation

The uninstallation command in the current documentation is:

dsh plugin --profile web remove @deepseek-ai/dsh-codex-importer

The installation command uses github:life1996cou/dsh-codex, while the uninstallation command uses @deepseek-ai/dsh-codex-importer; the name in package.json is also @deepseek-ai/dsh-codex-importer. The documentation does not explain the mapping relationship between the GitHub repository install name and the package name.

Use Cases and Notes

Suitable for those who already have local Codex sessions and wish to reuse historical context in DSH Web. It is recommended to:

  • Confirm that the Codex session directory is accessible; the default path is ~/.codex/sessions
  • Check the source code and license before installation; the current license is MIT
  • The plugin runs with the permissions of the current dsh process; confirm trustworthiness of the source repository and dependencies before installation
  • Use file: for local directory installation; do not use bare paths

Conclusion

The value of dsh-codex lies in bringing local Codex sessions into the web interface as new DSH sessions, preserving the complete conversation history.

The extension philosophy of DSH is “everything is a plugin,” and the community directory is an independent site with no official affiliation with DeepSeek / Hypersphere.

GitHub Repository: https://github.com/life1996cou/dsh-codex

The directory page URL does not appear in the currently verified information, so no specific address is provided here.