Claude2DSH

Move Claude Code conversations, skills, memory, and plugin assets into DeepSeek Harness as native, resumable sessions — and take DSH turns back to Claude Code JSONL when you need to.

简体中文

Claude Code is the first source adapter in a multi-tool migration layer. Claude2DSH preserves the useful conversation structure, writes through DSH's native persistence APIs, and keeps the original Claude directory read-only by default.

[!NOTE] 0.2.0-rc.5 is a release candidate. The Awesome badge means the project is included in the curated awesome-dsh-plugin list under Sessions & Messages. The automatic awesome-dsh-plugins radar has not marked it as runtime-verified; the badge does not claim that verification.

Why Claude2DSH

The governing principle is zero-configuration by default: the default path produces a visible result without requiring users to understand profiles or bundles first, while dangerous write-back remains explicitly gated.

flowchart LR
    A["Claude Code JSONL<br/>~/.claude/projects<br/>read-only"] --> B["Claude adapter<br/>discover · parse · normalize"]
    B --> C["Normalized session IR<br/>turns · steps · tools · images"]
    C --> D["DSH event synthesis<br/>native session events"]
    D --> E[("DSH sessions<br/>$DSH_HOME/sessions")]
    E --> F["Export / sync<br/>safe copy"]
    F --> G["Claude Code JSONL<br/>resumable transcript"]
    E --> H["Settings UI + tools<br/>import · export · sync · merge"]

Quickstart

Requirements: Node.js >=22.19.0, pnpm, and the dsh CLI.

# Install the published plugin into DSH's built-in headed profile
dsh plugin --profile web add @claude2dsh/plugin@0.2.0-rc.5

# Start the browser UI; the terminal prints the local URL
dsh web

Then:

1. Open the URL printed by dsh web.
2. On a fresh DSH installation, choose Configure later if the model API-key prompt appears; migration itself does not call a model.
3. Open Settings → Claude2DSH.
4. Choose a language, confirm the Claude sessions directory, and optionally include subagent/workflow transcripts.
5. Click Preview import, inspect the counts and item report, then click Run import.

flowchart LR
    S1["Install plugin<br/>dsh plugin --profile web add ..."] --> S2["Start UI<br/>dsh web"]
    S2 --> S3["Open Settings → Claude2DSH"]
    S3 --> S4["Preview import"]
    S4 --> S5["Run import"]
    S5 --> R["Native DSH sessions<br/>listed in Session sources"]

The first section of Settings → Claude2DSH is the migration guide; Chinese is the default UI language and English is selectable. If port 3080 is already in use, run dsh web --port 0 and open the URL printed by DSH.

Preview is read-only and returns an itemized plan before any DSH write.

This is what a successful run looks like. The screenshot comes from the real 0.2.0-rc.5 UI using a synthetic, privacy-safe Claude transcript.

Repository helper

If you cloned this repository, the helper performs the same install into the main web profile and starts the UI on DSH's default local port (3080):

bash scripts/install-claude2dsh.sh

Set CLAUDE2DSH_PROFILE only when you intentionally want a custom profile. Headless profiles expose the same tools but do not include the browser UI.

Capabilities: when and how to use them

Session import is idempotent: running it again reports an existing session instead of duplicating it. The default search is recursive and respects CLAUDE_CONFIG_DIR (falling back to ~/.claude/projects), and the first-run guide displays the discovered source root and result counts. Project-level CLAUDE.md is not copied because DSH already reads it natively; only user-global context needs conversion.

Settings tour

The Claude2DSH settings page keeps the first migration and safety-critical defaults in one place:

• First-run migration — language, source directory, optional subagents, preview, run, and itemized result.
• Auto mirror — opt-in watcher, debounce, and DSH-to-safe-copy direction.
• Import defaults — image mode/provider/model, subagent default, and sidecar size cap.
• Export / write-back — safe-copy target by default; original ~/.claude write-back is a separate dangerous switch.
• Claude hook bridge — startup-only paths and activation guidance.
• Session sources — imported session ID, source kind, and source path.

The following real screenshots use the default Chinese UI and synthetic data; labels switch with the language selector.

Safety model

• Import treats the Claude source as read-only. Preview performs no DSH write.
• DSH writes go through host persistence and the DSH-native roots under $DSH_HOME/sessions, $DSH_HOME/skills, and $DSH_HOME/claude2dsh.
• Export and sync default to $DSH_HOME/claude2dsh/exports; they do not write the original ~/.claude.
• Writing the original Claude directory requires explicit allowOriginalClaudeDir: true authorization and remains refused by default.
• Plugin inventory reads assets without executing plugin code.
• Auto mirror pauses on concurrent growth. The explicit merge tool creates a new safe copy instead of guessing which side wins.

Current limitations

• Release-candidate status: the public package is 0.2.0-rc.5; interfaces and on-disk formats are not presented as a stable compatibility promise yet.
• Hook bridge: the upstream bridge supports 7 of Claude Code's 30 hook events, only type: "command" handlers, and partial semantics per supported event. Full hook compatibility is a roadmap goal, not a current claim.
• Vision acceptance: the native image path is implemented, but it has not been accepted against a real vision-capable DSH model route. The shipped DeepSeek adapter declares text-only input.
• Auto mirror: it is opt-in and off by default. It writes DSH turns only to the safe Claude export copy; when both sides grow, it pauses and reports a conflict. Automatic merge is not implied.
• Plugin compatibility: inventory and selected assets can migrate, but arbitrary Claude plugin runtime behavior is not automatically portable to DSH.
• Source adapters: Claude Code is currently the only adapter. Codex and other tools remain roadmap work.
• Session-list decoration: DSH has no per-session sidebar-row extension point, so source identity is shown in Settings and through claude2dsh_session_sources instead.

FAQ

License and acknowledgements

MIT. The project was designed independently and benefited from the published work of dsh-chat-import (MIT) and dsh-claude-move (Apache-2.0); thanks to both projects for useful reference points. Hook compatibility delegates to the official DeepSeek Harness Claude Code hook bridge package.