CC2DSH session bridge

English | 中文

Move local conversations among Claude Code, DeepSeek Harness (DSH), and Codex. The implemented edges are Claude Code → DSH, DSH → Claude Code, and DSH → Codex. Claude Code → Codex is already provided by Codex and is not duplicated; the remaining directions are deferred.

This README is for people. Agent execution rules, backup requirements, and script parameters live in SKILL.md, keeping user guidance and AI instructions separate.

Installation

Copy the entire project directory, not SKILL.md alone. After installation, the named skill directory must directly contain SKILL.md, scripts/, and references/.

The templates below are portable placeholders, not paths from a real machine:

Scope	Codex destination	Claude Code destination
All projects for one user	<user-home>/.agents/skills/cc2dsh-session-bridge/	<user-home>/.claude/skills/cc2dsh-session-bridge/
Current project only	<repository-root>/.agents/skills/cc2dsh-session-bridge/	<repository-root>/.claude/skills/cc2dsh-session-bridge/

Choose one scope and copy the complete directory to the matching destination. To use the skill in both agents, copy it to both discovery locations, or keep one source copy and use directory links supported by the operating system. Codex officially supports symlinked skill folders.

Verify the installation:

• In Codex, open /skills and check for cc2dsh-session-bridge; invoke it explicitly with $cc2dsh-session-bridge when desired.
• In Claude Code, invoke /cc2dsh-session-bridge. If it is missing, make sure the copied directory is not nested one level too deep; restart the session if necessary.

Codex users may alternatively ask $skill-installer to install this repository; it selects a skill location supported by the installed Codex version.

Usage

After installation, describe the desired migration in natural language. A safe request is:

Use cc2dsh-session-bridge to import my selected DSH conversation into Claude Code. Discover this machine's actual configuration, back up and verify the original first, then preview the conversion. Do not overwrite conflicts without my confirmation.

For Codex:

Use cc2dsh-session-bridge to import this DSH conversation into Codex. Do not edit Codex internal files. Preview first and wait for my confirmation before calling the official importer.

The agent discovers session sources, destination roots, executables, and local service settings on the current device, then supplies those values to the scripts. Users should never copy another machine's directory, username, IP address, or port into their setup.

Safety and privacy

• Writes are previewed first; Codex import also has an explicit apply gate.
• Selected source conversations are backed up and the backup is verified by hash or byte comparison before migration.
• A different existing Claude target is a conflict and is not overwritten without explicit authorization.
• Codex imports use its external-session importer and never edit rollouts, databases, or indexes directly.
• The repository does not retain real usernames, hostnames, IP addresses, ports, user-data directories, session identifiers, or machine-specific version probes. Host-specific values are discovered at runtime and must not be committed in docs, examples, fixtures, or logs.
• Historical working directories may differ after moving between machines. The agent verifies a destination mapping instead of guessing one.

Capabilities and limits

• DSH logs use the required multi-frame zstd layout and validate turn/end.reason.
• Titles, ordinary messages, working directories, and paired tool traces are preserved where possible.
• DSH does not preserve signatures required by native Claude thinking blocks. Reasoning is therefore omitted by default, or included only as clearly marked ordinary text when explicitly requested.
• Python 3.10+ and zstd are required. Workspace attachment needs compatible Node.js; DSH → Codex needs a Codex build with the external-session importer.

Project structure

File or directory	Audience	Purpose
README.md / README.zh.md	People	Installation, invocation, and safety boundaries
SKILL.md	AI agents	Discovery, backup, preview, conversion, validation, and import protocol
scripts/	AI agents	Deterministic conversion and validation programs
references/	Agents / maintainers	Architecture, compatibility, and portability details

Official references

• Codex: build and install skills
• Claude Code: Skills
• DeepSeek Harness

License

MIT