dsh-plugin-codex-import

English | 中文

A DeepSeek Harness plugin
that imports your OpenAI Codex conversation history into DSH sessions —
grouped into project workspaces, resumable, searchable, forkable — from a
single slash command.

/codex-import

Imported 679 session(s) from /Users/you/.codex.
Scanned 681, already present 0, failed 0.
Content: 10694 turns, 81513 steps, 13580 user messages, 81513 assistant messages, 101215 tool calls.
Grouped 529 session(s) into 116 workspace(s).
Reload the interface to see the imported sessions.

Install

dsh plugin --profile web add github:Gordonynh/dsh-plugin-codex-import

Then add it to your profile's ~/.dsh/profiles/web/cordis.patch.yml:

- insert:
    - id: codex-import
      name: 'dsh-plugin-codex-import'

Restart the harness. Verify it composed with
dsh --profile web --dump-config | grep codex-import.

Usage

Command	Effect
/codex-import	import every not-yet-imported Codex session
/codex-import --dry-run	report what would be imported, write nothing
/codex-import --limit 20	stop after 20 sessions
/codex-import --since 30	only sessions from the last 30 days
/codex-import --project ~/work	only sessions whose cwd is under a path
/codex-import --archived	also scan ~/.codex/archived_sessions

Re-running is safe: already-imported session ids are skipped, and Codex
originals are never modified.

Configuration

- insert:
    - id: codex-import
      name: 'dsh-plugin-codex-import'
      config:
        codexHome: '~/.codex'        # default: $CODEX_HOME, else ~/.codex
        provider: 'codex'            # recorded on imported assistant messages
        groupIntoWorkspaces: true    # attach imported sessions to workspaces

How the mapping works

Codex (rollout-*.jsonl)	DeepSeek Harness session events
session_meta	session header (id, createdAt, cwd)
user message (human)	user/message, source:{kind:"user"}
injected context / developer role	user/message, source:{kind:"plugin",plugin:"codex-import"}
reasoning	reasoning block on assistant/message
assistant message / agent_message	text block on assistant/message
function_call / custom_tool_call	tool-call block + tool/call event
*_output items	tool/result, call-id matched within the step
web_search_call / tool_search_call / image_generation_call	balanced tool/call + tool/result pair
turn_context.model	AssistantMessage.source.model
first human prompt	session/title event (no auxiliary model call)
event_msg telemetry, ghost_snapshot, token counts	dropped (UI duplicates)

Codex records a flat item stream; the harness wants it bracketed into
turn/start → (user/message | step/start … step/end)* → turn/end. The plugin
rebuilds that structure using Codex turn_id stamps where present, and human
message boundaries otherwise.

Storage is the harness's own. Sessions are written through
ctx.sessionPersistence.create() / .append() and grouped through
ctx.workspaceRegistry.create() / workspace.attachSession(). The plugin
never touches the session directory, the zstd container, or the workspace
registry file — physical encoding, path layout, durability, and workspace
accounting all stay where they belong, so a harness format change cannot
silently desync this plugin.

Repairs applied during conversion: dangling tool calls get a synthetic error
result (TOOL_NOT_STARTED) so no assistant message carries an unanswered
call; orphan tool outputs are dropped; non-JSON custom-tool input is wrapped
as {"input": …} so tool/call.arguments stays parseable; images become a
text placeholder (harness image blocks need attachment-service references a
plugin cannot mint); Codex-compacted sessions import their full
pre-compaction history.

Sessions whose project directory no longer exists are imported but stay
ungrouped — a workspace must point at a real directory, which is the
harness's own rule.

Verification

node test/verify.mjs        # grammar, argument parsing, mapping edges,
                            # + folds every real rollout through the harness
node test/integration.mjs   # boots real dsh-session, persistence and workspace
                            # plugins in a scratch root and imports through them

verify.mjs runs the harness's own foldSurface / deriveEventMessage — the
exact reconstruction path a resumed session uses. integration.mjs proves the
harness's real persistence accepts the headers and event batches this plugin
produces, and that the workspace registry accepts the resulting sessions.

On the author's machine: 679 real sessions, 196k+ reconstructed messages, zero
failures.

Caveats

• DSH is in developer preview and pins its session format at version 0 with
  no compatibility promise. If a future harness refuses v0 logs, re-run
  the import — Codex originals are untouched.
• Resuming an imported session sends its history to whatever model DSH has
  configured; provider-specific replay state is not carried over.
• Requires Node ≥ 22 (the harness's own floor).

License

Source-available under a custom license — not an OSI-approved open-source
license. Summary (the license texts control):

Who	Rights
Everyone	free noncommercial use, modification, redistribution (same license, keep notices)
Individuals, worldwide	additionally: commercial use
DeepSeek & its partner enterprises	additionally: commercial use, closed-source/proprietary derivatives, sublicensing — see the supplement
Other organizations	noncommercial only; commercial use requires a separate license from the author

LICENSE.md · LICENSE-SUPPLEMENT-DEEPSEEK.md · NOTICE.md