dsh-session-importer

A dsh plugin that imports
session records from other coding agents into the dsh session store, so
they appear in the session list/search, render in the conversation UI, export,
and resume like any native dsh session.

Supported sources

Unrecognized record types (attachments, hooks, summaries, snapshots) are
skipped; tool results without a matching tool call are skipped and counted.

Installation

Install the package into a dsh profile and register the plugin row:

# 1. install into the web profile (from anywhere)
dsh plugin --profile web add file:/absolute/path/to/dsh-session-importer

# 2. append a patch row to ~/.dsh/profiles/web/cordis.patch.yml

- insert:
    - id: session-importer
      name: dsh-session-importer

Then restart dsh web (or dsh --profile headless if you also install it
there) to load the plugin.

After editing the plugin source, re-run the dsh plugin --profile web add
command — pnpm installs a snapshot copy into the profile, not a live link.

Usage

In the web UI command palette (or any command surface):

/import-sessions [<path>] [--source auto|claude|codex|jsonl|markdown] [--cwd <dir>] [--limit <n>] [--dry-run] [--retitle]

• No <path> — auto-discovers the known agent data directories listed above.
• <path> a file — imports that one transcript.
• <path> a directory — scans recursively for *.jsonl (*.md only with
  --source markdown).
• --source — force a parser; default auto detects per file.
• --cwd <dir> — override the recorded working directory of imported sessions.
• --limit <n> — cap messages per imported session (default unlimited).
• --dry-run — scan, parse, and report without writing anything.

• --retitle — backfill titles + sidebar projections for sessions imported by
  an older plugin version, without re-importing. Runs inside the host process
  (no restart needed). Run it once after upgrading the plugin:

  /import-sessions --retitle

Examples:

/import-sessions
/import-sessions ~/.claude/projects
/import-sessions /path/to/export.jsonl --source claude
/import-sessions /path/to/transcript.md --source markdown --cwd /path/to/project
/import-sessions --dry-run

Behavior notes

• Idempotent: each source file maps to a deterministic session id
  (import-<source>-<hash>, versioned — a parser fix bumps the hash input, so
  re-importing after an upgrade creates fresh sessions instead of being
  rejected as duplicates). Re-importing the same file unchanged is skipped as a
  duplicate, so running the command repeatedly is safe.
• Durability: imports write directly through the dsh session-persistence
  backend (the same append-only, fsync-durable machinery the live agent path
  uses), so no live agent session is required and writes survive restarts.
• Fidelity: tool calls are kept as tool-call content blocks plus
  tool/call + tool/result events (paired by id), mirroring native dsh
  sessions; Claude Code thinking blocks and Codex reasoning blocks are
  imported as reasoning content blocks so tool-heavy turns still show the
  model's reasoning; very long blocks are truncated (200 KB text / 100 KB tool
  results) to keep imports bounded.

Development

node test/harness.mjs   # boots an in-process cordis context + jsonl persistence
                        # against a temp root, imports the fixtures, and
                        # verifies the resulting logs reload cleanly

Requires the @deepseek-ai/* packages resolvable from the plugin directory
(they are when the plugin is installed into a dsh profile).