dsh-codex-migrate
Codex 与 DeepSeek Harness 之间的单向结构化对话、项目、MCP、记忆和上下文迁移。Codex 与 DSH 的单向结构化迁移插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-codex-migrate@2.0.4Codex Migrate 以 dsh-codex-migrate 发布，当前版本为 2.0.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Predictable one-way structured migration between Codex and DeepSeek Harness
English · 中文
Version 2.0 turns the plugin into a two-sided migration bridge. Import Codex tasks into DSH, or move one DSH conversation—or every active conversation in a project—into Codex. Every action is an explicit one-time import; the source conversation is never modified later by background synchronization.
dsh-codex-migrate@2.0.4 carries the compatibility fixes introduced in v2.0.3 and is verified with the public npm @deepseek-ai/dsh@0.1.5-rc.2 (latest as checked on 2026-09-23). Those fixes address DSH's newer session persistence and Web client modules:
SessionHandle API, including flush/close, with a fallback for older persistence services.codex:// navigation, while retaining browser navigation as a fallback.The npm next and alpha DSH channels are not claimed as supported by this release. See the changelog for the release history.
continue-in-dsh Skill let a Codex user say “Continue in DSH” to import and open the current task in DSH.(no project) / codex-unprojected workspace.remember_memory, search_memory, and forget_memory provide local persistent memories with global, project, and conversation scopes.The Codex icon appears beside DSH's native copy and feedback actions:
Version 2.0 intentionally does not provide shared conversations, background bidirectional sync, conflict merging, or a Codex inline monitor. Each import is inspectable, repeatable, and cannot silently rewrite the same history on both sides.
The complete experience has two local components:
| Component | Installed in | Purpose |
|---|---|---|
dsh-codex-migrate | DSH | Reads, converts, and creates DSH/Codex conversations; hosts the loopback-only handoff service |
dsh-codex-bridge MCP + Skill | Codex | Provides “Continue in DSH,” MCP memory tools, and the trigger workflow |
The DSH plugin alone supports settings-page imports and DSH → Codex actions. Install the Codex companion as well to start imports from Codex or use MCP memory.
node available in the terminal; Node.js 18 or newer is recommended.web profile. Replace web if you use another profile.First installation:
dsh plugin --profile web add dsh-codex-migrate
Upgrade from an earlier version:
dsh plugin --profile web update dsh-codex-migrate
Restart DSH, then open Settings → Codex Migration. You should see Imported Conversations, Batch Migration by Project, and Memory Import.
The MCP server and Skill are bundled in this repository, so keep the cloned directory available locally:
git clone https://github.com/polarskicpl/dsh-codex-migrate.git
cd dsh-codex-migrate
If you already cloned the repository, update it with git pull.
Windows PowerShell:
$bridge = (Resolve-Path ".\codex\dsh-codex-bridge\mcp\server.mjs").Path
codex mcp add dshCodexBridge -- node $bridge --stdio
macOS / Linux:
bridge="$(pwd)/codex/dsh-codex-bridge/mcp/server.mjs"
codex mcp add dshCodexBridge -- node "$bridge" --stdio
If the same MCP name is already registered with an old path, run this first and then repeat the add command:
codex mcp remove dshCodexBridge
Verify the registration:
codex mcp list
Codex also supports direct ~/.codex/config.toml configuration, but the CLI avoids path and TOML escaping mistakes. See the official Codex MCP documentation.
continue-in-dsh SkillWindows PowerShell:
$skills = Join-Path $HOME ".agents\skills"
New-Item -ItemType Directory -Force -Path $skills | Out-Null
Copy-Item -Recurse -Force ".\codex\dsh-codex-bridge\skills\continue-in-dsh" $skills
macOS / Linux:
mkdir -p ~/.agents/skills
cp -R ./codex/dsh-codex-bridge/skills/continue-in-dsh ~/.agents/skills/
Codex discovers user skills in ~/.agents/skills. Restart Codex if an updated skill does not appear immediately. See the official Codex Skill documentation.
dshCodexBridge is connected in /mcp.continue-in-dsh appears in /skills.Continue in DSH.已同步对话到 DSH。The MCP server exposes four tools:
| Tool | Purpose |
|---|---|
continue_in_dsh | Import the current Codex task once and open DSH |
remember_memory | Save a local persistent memory |
search_memory | Search memories in one scope |
forget_memory | Delete a memory by ID |
Use DSH MCP to remember that my test code is ocean-blue-728.Search DSH MCP memory and tell me my test code.ocean-blue-728, ask it to forget that memory.Memories are stored locally at ~/.codex/dsh-codex-bridge/memory.jsonl. They are not uploaded by this plugin and do not re-enable shared conversations.
| Content | Codex → DSH | DSH → Codex |
|---|---|---|
| User and assistant messages | ✓ | ✓ |
| Tool calls and tool results | ✓ | ✓ |
| Latest regenerated assistant reply | ✓ | ✓ |
| One conversation | ✓ | ✓ |
| Project-less conversations | ✓ | — |
| Batch import by project | ✓ | ✓ |
AGENTS.md and project text files | Optional | — |
| Codex / MCP / Memory Skill memories | Optional | — |
DSH → Codex uses Codex's supported external-agent session import path. Every task in a project batch receives the same original working directory, while Codex remains responsible for sidebar organization.
The first refresh scans existing Codex sessions. Later refreshes reuse a size + mtime + hash incremental cache and parse only new or changed JSONL files. Removed files are dropped from the cache and corrupted files are isolated.
The cache lives under inventory/ in the migration output directory. Removing it only causes one full rebuild; it does not delete source conversations.
| Key | Default | Meaning |
|---|---|---|
codexDir | '' | Codex data directory; empty auto-detects ~/.codex |
outputDir | '' | Migration output; empty uses <DSH_HOME>/codex-sync |
language | en | en, zh, or auto to follow the UI locale |
sessionMode | new | all, new, or selected |
projectMode | all | all or selected |
includeMemories | true | Import Codex Markdown memory |
includeMcpMemories | true | Import bridge MCP persistent memory (Beta) |
includeMemorySkill | true | Import Memory Skill storage |
importAsDshSessions | true | Create native DSH sidebar conversations |
bridgeEnabled | true | Enable the loopback-only one-shot handoff service |
127.0.0.1.outputDir, DSH session storage, and the local MCP memory file.npm run build
npm test
npm run test:bridge
npm pack --dry-run
See CHANGELOG.md for release history.
MIT