CC2DSH session bridge
August 25, 2026 · View on GitHub
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
/skillsand check forcc2dsh-session-bridge; invoke it explicitly with$cc2dsh-session-bridgewhen 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
zstdare 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 |