Keep your Claude Code history when you move to DeepSeek Harness. One install copies every Claude session, memory, skill and CLAUDE.md into DSH as resumable sessions — grouped in a dedicated claudecode workspace (one workspace per project is optional).
Copy-only · Seamlessly resumable · Per-project workspaces · Live sync with Claude Code
English | 中文 | Español | Português | हिन्दी
Developer preview (0.1.0). Roadmap and design: PLAN.md · change history: CHANGELOG.md.
- 🔍 Auto-discovery — locates the Claude data root (
$CLAUDE_CONFIG_DIR, fallback~/.claude) and indexes every project/session (title, timestamps, message & tool-call counts), directory & git state, memories, skills, globalCLAUDE.mdandsettings.json— with incremental caching that re-reads only changed files and parallel project scanning (scanConcurrency). - 📥 Full-fidelity history import — balanced, resumable DSH sessions (
turn/start → step/start → user/message → assistant/message → tool/call → tool/result → step/end → turn/end), malformed lines reported with line numbers. Interrupted tool calls are repaired so everytool_usehas exactly one result (no more permanent 400s on resume). Transcripts larger thanmaxTranscriptBytesare stream-imported in chunks (memory O(chunk)) instead of being rejected. - 🗂 One
claudecodeworkspace (default) — every imported session lands in a dedicated "claudecode" workspace rooted at a fresh folder ($DSH_HOME/claudecodeby default; the only thing the plugin ever creates).workspaceMode: 'per-project'restores one-workspace-per-project grouping. - 🔁 Copy-only & incremental — nothing on either side is moved, rewritten, or deleted. Re-running the import appends only the new turns to the same DSH session;
force: truesaves an extra full copy under a new id. - 🧠 Personal context, always fresh — memories injected as a live prompt section (current project first,
memoryScope), Claude skills registered as real DSH skills (global and project-level.claude/skills, non-skill docs likeREADME.mdskipped), global + projectCLAUDE.mdinjected early. Even with theclaudecodeworkspace, the original project directory is remembered for memory/CLAUDE.mdresolution. - ⚡ Live sync with a running Claude Code — keep using Claude Code side by side; each re-run brings only what changed.
- 🖥 Web panel & one-shot commands —
/claude-import-all,/resume-claude,/claude-move-reset, and a floating migration panel with progress, cancel, paging, "open session", automatic session-list refresh (no page reload on current shells) and zh/en texts. - 🛡 Safety first — source files strictly read-only, DSH logs append-only, secrets reported by position only, permission-class records counted but never imported.
# 1. Install
dsh plugin --profile web add -w github:PerryLink/dsh-claude-move- In any DSH session, run one command:
/claude-import-all # scan → copy every Claude session → report
- Refresh the already-open Web page once (the panel has a 「刷新会话列表」 button) and click any imported session to continue. No DSH restart is needed — see After importing.
Prefer fine-grained control?
claude_scan # structured index of all projects/sessions
import_claude { path: "~/.claude/projects" } # one project directory (recursive)
import_claude { path: "all" } # everything
~/.claude (read-only)
├─ projects/*/*.jsonl ──→ resumable DSH sessions, grouped in one "claudecode" workspace (default)
├─ projects/*/memory/ ──→ live system-prompt memory section (re-read per request)
├─ skills/** ──→ real DSH skills
└─ CLAUDE.md + settings ──→ early prompt section + config suggestions (never auto-applied)
| In Claude Code | Lands in DSH as |
|---|---|
Session transcripts (projects/*/*.jsonl) |
Balanced, resumable DSH sessions — full-fidelity user/assistant/tool/thinking mapping with interrupted-tool-call repair — grouped into one claudecode workspace (default $DSH_HOME/claudecode) or one workspace per project (workspaceMode: 'per-project') |
Memory files (projects/*/memory/*.md) |
A live system-prompt context section, re-read on every request (feedback > project > reference > user) — the original project directory is remembered even inside the claudecode workspace |
Skills (~/.claude/skills/**) |
Real DSH skills (kebab-case names, collision suffixes, max 30 by default; README.md/MEMORY.md and files without a description are skipped) |
CLAUDE.md (global + per-project) |
An early prompt section; the project file wins |
settings.json |
DSH configuration suggestions with an explicit unmappable-keys list |
| Project state (directory, git branch & dirty count) | Shown in the scan index, the Web panel badges, and the /resume-claude handoff |
# From GitHub
dsh plugin --profile web add -w github:PerryLink/dsh-claude-move
# Local checkout (development)
dsh plugin --profile web add -w link:/path/to/dsh-claude-move
# From a packed tarball
dsh plugin --profile web add -w ./dsh-claude-move-0.1.0.tgzThe package is pure ESM with no build step, so Git installs need no prepare script or allowBuilds entry. See the official package & install guide.
Call the tools in any session with the plugin mounted:
claude_scan # full scan (incremental cache)
claude_scan { path: "~/.claude/projects/<slug>" } # partial scan
claude_scan { refresh: true } # skip cache, rescan everything
claude_scan { projectsLimit: 10, sessionsLimit: 5, fields: "brief" } # trim output
import_claude { path: "~/.claude/projects/<slug>/<sessionId>.jsonl" } # one session
import_claude { path: "~/.claude/projects" } # directory (recursive)
import_claude { path: "all" } # everything
# Re-run any time: unchanged files are skipped, grown transcripts append only the new turns.
# Files over maxTranscriptBytes are stream-imported in chunks (no memory ceiling).
import_claude { path: "...", force: true } # fresh full copy as import-<src>-<n> (previous copy kept)
Commands (user-triggered, no model turn):
/claude-import-all # one-shot: scan → import everything → report → inject into the current session
/resume-claude latest # continue the most recent Claude session
/resume-claude <sessionId> # by source session id or import-<src> id
/resume-claude <keyword> # match titles; multiple matches are listed, never guessed
/claude-move-reset # reset the plugin cache (bookmarks + import map); imported sessions are kept
Web panel: a floating 🐳 Claude 迁移 button (bottom-right) opens the migration panel — project/session tree with status badges (not imported / imported / imported-with-new-turns / source missing / directory missing / git dirty), keyword filter, paged rendering, per-session "Import & continue" + "Open session" + "Refresh session list", batch import with a live progress bar and cancel, and a cache-reset button. Texts follow the browser language (zh/en). Served through the plugin's own /api/claude-move/* JSON routes registered on the public ctx.webServer seam.
- Scan returns a structured JSON index: projects (slug/cwd/directory existence/git branch & dirty count), sessions (title/timestamps/message & tool-call counts/malformed lines), memories, skills, global CLAUDE.md and settings.json; each session carries
import.status(none/imported/source-missing) plusimport.updatesPendingwhen the source has new unsynced turns.settingsSuggestionsholds the DSH translation of settings.json plus the unmappable keys (see Compliance). - Import maps user/assistant/tool/thinking messages with full fidelity; interrupted tool calls are repaired (exactly one result per
tool_use), and the result is a balanced, resumable session attached to theclaudecodeworkspace (default) or its per-project workspace. Batch results are per-file (imported/appended/already-imported/skipped/failed), malformed lines carry line numbers, suspected secrets are reported by position only (file:line:kind), and permission-class records are counted but never imported. Importing never deletes or rewrites anything: existing DSH sessions are untouched, previously imported copies are kept, and Claude's source files are never written to. - Personal context takes effect automatically (no import action needed):
- Memories:
projects/*/memory/*.mdare injected as a dynamic context section, re-read per request (new memories apply immediately), orderedfeedback > project > reference > user, capped at 8 KiB by default. WithmemoryScope: current-project(default) only the current session's project memories are injected (all projects fall back when the cwd has no matching project);allinjects everything with the current project first. Inside theclaudecodeworkspace the plugin resolves the original project from the recordedsourceCwd. - Skills:
~/.claude/skills/**/SKILL.md(plus flat*.md) and the current project's.claude/skills/**become DSH skills (names normalized to kebab-case, collisions suffixed, max 30;README.md/MEMORY.mdand description-less files are skipped so they can never break skill loading); DSH owns catalog injection and theskilltool. - Instructions: global
~/.claude/CLAUDE.mdplus the current session's.claude/CLAUDE.mdare injected as an early prompt section (project wins; resolved viasourceCwdinside theclaudecodeworkspace).
- Memories:
You do not need to restart DSH. Imports land durably through the public sessionPersistence service the moment they complete:
- The server-side lists (
session.list/workspace.listRPCs, the CLI, any new page load) show the imported sessions under theclaudecodeworkspace (one per project withworkspaceMode: 'per-project') immediately. - The panel refreshes the already-open page's session list itself (via the shell's
sessions/workspacesclient services on current shells) and offers an Open session button per imported session. On older shells without those services it falls back to the 「刷新会话列表」 button / a page reload — imports write cold sessions directly through the persistence service, so they do not emit the livehost/session-addedframe; workspace groups, however, do update live (host/workspace-changed). - Imported sessions can be opened, read, and resumed right away —
/resume-claude, or click the session in the list. The handoff states the original project directory. Re-running the import at any time syncs only the new turns into the same sessions.
All optional, overridable in cordis.yml:
- id: claude-move
name: dsh-claude-move
config:
claudeHome: null # default: $CLAUDE_CONFIG_DIR or ~/.claude
workspaceMode: claudecode # 'claudecode' (default: one dedicated workspace for all imports) | 'per-project' (one workspace per source cwd)
claudecodeDir: null # claudecode workspace folder; default $DSH_HOME/claudecode (the only folder the plugin ever creates)
scanGit: true # git probe level: true (full) | 'branch' (zero git calls) | false
gitTimeoutMs: 5000 # git subprocess timeout
scanConcurrency: 8 # parallel project scan cap
maxTranscriptBytes: 67108864
excludeProjects: [] # slug substrings to skip, e.g. ['demo-']
enableMemory: true
memoryMaxBytes: 8192
memoryScope: current-project # 'current-project' (only the current cwd's project) | 'all' (current first)
enableSkills: true
maxSkills: 30
extraSkillDirs: []
enableInstructions: true
resumeMaxChars: 2048 # handoff summary char cap
resumeMode: inject # 'inject' (handoff summary) | 'agents' (ctx.agents.resume)
enableWebPanel: true # register the /api/claude-move/* panel routes
importConcurrency: 4 # parallel read+convert per batch (persisting stays sequential)Remove the claude-move row from the profile's bundles and restart dsh. Imported sessions stay in DSH's data directory; the plugin only writes its cache ($DSH_HOME/claude-move/) and the claudecode workspace folder, and never touches Claude source data.
- Targets
dsh 0.1.0-rc.6(web profile); peer dependencies pinned to0.1.0-rc.6. Node^22.19 || >=24. - Last verified 2026-08-13 on Windows (Node 22) against
@deepseek-ai/dsh@0.1.0-rc.6: fresh tarball install, real scan (40 projects / 2387 sessions), real batch import 13/13 with idempotent re-import 13/13, workspace attach and persistence artifacts confirmed. macOS/Linux now covered by the CI matrix. - Verified 2026-08-14 against the current
deepseek-harnesscheckout (web profile, JSONL+zstd session backend, real workspace registry) in an isolated home: full web boot with the plugin mounted, scan + import-all through the panel routes,claudecodeworkspace creation with sessions attached, incremental append to an existing imported session (contiguous seq, loads cleanly), restart-safe re-import, and untouched pre-existing DSH sessions throughout. No session is ever archived, deleted, or rewritten.
| Surface | Used | Fallback when absent |
|---|---|---|
Host services (tools / sessionPersistence / workspaceRegistry / commands / systemPrompt / skills / webServer) |
required where listed | optional services register reactively via internal/service; missing fs fails loud |
sessionPersistence.listSnapshots / readFrom / streamText-capable fs / ctx.jobs / ctx.agents.resume |
feature-detected | list() / whole-file read with loud rejection / own job map / handoff inject |
Client shell services (sessions.refresh/open, workspaces.refresh) |
feature-detected at panel apply | full-page reload |
| Newer platform capabilities are never hard requirements — the plugin stays bootable on rc.6. |
- Reads
~/.claude(transcripts, memories, skills, CLAUDE.md, settings.json) — strictly read-only — and the project directories it imports into (workspace attach inper-projectmode). - Writes DSH session logs via the public
sessionPersistenceservice — create + append only, never deletes, rewrites, or archives existing sessions — workspace-registry records, its own cache under$DSH_HOME/claude-move/(scan bookmarks + import map), and theclaudecodeworkspace folder ($DSH_HOME/claudecodeby default; a plainmkdir, never any deletion). - Never modifies Claude source files, touches other applications' data, or accesses the network.
- No credentials are read or transmitted; suspected secrets in transcripts are reported by position only.
- Source files are strictly read-only; DSH session logs are append-only (
create+appendonly). - External transcripts are untrusted input: nothing in them is executed; system/developer/thinking content never enters the resume handoff.
- No changes to the DSH engine, official UI packages, or apiproxy — only public services (
sessionPersistence/workspaceRegistry/tools/commands/systemPrompt/skills/webServer). - Suspected secrets are reported by location only (never their content);
permission/permission-mode/queue-operationrecords are counted, not imported.
- Row not effective:
dsh --profile <p> --dump-configshould print# == dsh-claude-move; re-rundsh plugin --profile <p> add -w .... - Web boots but hangs silently: new profiles initialized by
dsh plugin addcontain onlydsh-base— add@deepseek-ai/dsh-web-apptodsh.profile.bundles. Installing into the existingwebprofile needs nothing. - Panel routes 404: they are served only when
enableWebPanel: trueand a web server is composed; check the boot log for FAILED fibers. - Import fails with "transcript 过大": raise
maxTranscriptBytesor import that file individually. - Import succeeded but the sidebar shows no new session: the page was already open — click the panel's 「刷新会话列表」 (or reload the page) once. No DSH restart is ever needed.
- Logs: boot failures print to the
dshconsole; the plugin logs[claude-move]-prefixed errors for workspace/import-map issues.
- PLAN.md — research conclusions and the implementation plan.
- ARCHITECTURE.md — architecture diagram and the full data-mapping table.
- COMPLIANCE.md — clause-by-clause audit against the official plugin constraints (deepseek-harness repo & docs, deepseek.com/harness, the developer docs, Cordis, and the Cordis paper).
- OPTIMIZATION.md — measured baselines and ranked optimization candidates.
- RELEASE.md — release checklist with acceptance evidence.
- CHANGELOG.md — what changed per version.
This project is licensed under the Apache License 2.0; the following MIT-licensed components retain their own licenses (full text in THIRD_PARTY_NOTICES.md):
- Conversion core vendored from Nwflower/dsh-chat-import (MIT).
- Discovery conventions & safety model from Demogorgon314/dsh-resume-plugin (MIT; its
session_reader.pyhas an Apache-2.0 upstream — see THIRD_PARTY_NOTICES.md). - Memory/skills injection & frontmatter parsing patterns from YYTbit/dsh-plugin-claude-bridge (MIT).
npm install # peer deps: @deepseek-ai/cordis, @deepseek-ai/dsh-tools@0.1.0-rc.6, @deepseek-ai/schemastery
npm test # node --test: convert (vendored + extended), discovery, import/report, context, settingsCI runs the full suite on Node 22 across Linux/macOS/Windows via GitHub Actions (test.yml).
- The model-facing surface is the two tools' descriptions/schemas and their outputs:
claude_scanreturns the structured index,import_claudereturns per-file summaries with positions of warnings. Tool results are themselves loggedtool/resultevents, so everything is reconstructable. - No hidden model-facing text; memory/CLAUDE.md sections are registered on
ctx.systemPrompt(prompt assembly, rebuildable from the session log).
- Titles come from
custom-title/ai-title/first prompt; Claudesummaryrecords are not used as titles. thinkingblocks are kept in the imported log asreasoningcontent, but never enter the resume handoff.- Interrupted tool calls are repaired with a synthetic error result (never dropped), so sessions with mid-turn interruptions stay resumable — the repair is reported in the import result (
repaired.synthesized). - Permission-class records are counted, not imported; DSH permission-preset suggestions are generated in reports.
- Claude
summaryrecords (context compaction) are reported but not mapped to DSH compaction nodes — synthesizing a valid compaction transaction would fabricate its seq range and checkpoint message, risking the platform invariants (see OPTIMIZATION.md). Full history is imported as original turns. - On hosts without a streaming
fs.streamTextsurface, transcripts larger thanmaxTranscriptBytesfail loudly instead of partial import; the chunked streaming path is used automatically wherever the surface exists. - In
workspaceMode: 'per-project', sessions whose source directory was deleted still import, but workspace attach fails (left ungrouped;workspace.attached: falseplus areasonin the report). The defaultclaudecodeworkspace does not depend on the source directory, so such sessions attach normally there. - Interrupted batch imports can be safely re-run (idempotent, append-only): finished files are skipped, grown files append only the new turns.
- If a transcript was truncated or reset in place (fewer turns than the recorded import), re-import skips it and reports
sourceShrunk; useforce: truefor a fresh full copy. - The Web panel is a zero-build floating panel driven by the plugin's own JSON routes; it does not use the shell's internal UI slot system (kept independent of undocumented rc.6 internals).
- For streamed appends, the per-run
messages/toolCallscounts cover only the newly appended events (the stored prefix is not re-read);turnsstays the full count.
Issues and pull requests are welcome — please use the provided templates (bug report, feature request). Questions and discussion live in the repo's GitHub Discussions. Report security issues privately via GitHub Security Advisories (repo Settings → Security; see SECURITY.md).
Thanks to everyone who helped make this plugin better:
- OLDnana1 — root-cause analysis of the interrupted tool-call corruption that made imported sessions permanently return HTTP 400 on resume (#1); fixed in v0.2.0.
- GooodWei — identified
README.md(and any description-less.md) being misregistered as a skill, which broke DSH's whole skill load (#1); fixed in v0.2.0. - Upstream MIT projects whose code and conventions this plugin builds on are credited in Attribution and THIRD_PARTY_NOTICES.md.
- DeepSeek Harness: repo · site · developer docs
- Plugin ecosystem:
dshtopic ·dsh-plugintopic · Discord
Apache License 2.0 — see LICENSE and NOTICE. Third-party notices (including the MIT text for the MIT-licensed components) in THIRD_PARTY_NOTICES.md.
This project is one of the 15 DeepSeek Harness plugins maintained by PerryLink. If this one helps you, the others likely will too:
| Plugin | One-liner |
|---|---|
| dsh-mcp-panel | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors |
| dsh-doublecheck | Engineering-discipline guard: requirements grill, test gates, adversary review |
| dsh-background-agents | Durable background child agents with a Web UI sidebar, messaging and interrupt |
| dsh-lsp-actions | LSP diagnostics, formatting, completion, code actions and rename over language servers |
| dsh-output-styles | Claude Code outputStyles-equivalent runtime style switching |
| dsh-checkpoint-rewind | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore |
| dsh-permission-rules | Claude Code-style declarative allow/deny/ask permission rules with audit |
| dsh-auto-review | Second-model auto-review on the approval chain, fail-closed by default |
| dsh-memento | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool |
| dsh-skill-pack-security | Security-audit skill pack: secret scan, dependency and supply-chain review |
| dsh-session-pin | Pin sessions in the Web sidebar with durable ordering |
| dsh-composer-history | Terminal-style input history for the web composer: arrows, Ctrl+R search |
| dsh-github | GitHub PR/issues integration for DSH, every write gated by approval |
| dsh-plugin-guide | Plugin-development knowledge base as an on-demand agent skill |
| dsh-claude-move | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH |