by yuzushi-dev
Create handoff documents and migrate active sessions between Claude Code and Codex.
# Add to your Claude Code skills
git clone https://github.com/yuzushi-dev/session-handoffGuides for using ai agents skills like session-handoff.
session-handoff is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by yuzushi-dev. Create handoff documents and migrate active sessions between Claude Code and Codex. It has 54 GitHub stars.
session-handoff's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/yuzushi-dev/session-handoff" and add it to your Claude Code skills directory (see the Installation section above).
session-handoff is primarily written in Python. It is open-source under yuzushi-dev on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh session-handoff against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
session-handoff creates handoff documents and migrates active sessions between Claude Code and Codex.
The main product is the managed plugin bundle: skills, the MCP server, client launchers, and the internal migration engine. The npm package distributes that bundle and exposes the setup CLI. It is not a separate migration dependency.
Use the managed setup command:
npx session-handoff@latest setup
The command installs a user-scoped plugin bundle, registers the MCP server, installs the client skill, and wraps each selected client launcher. Existing launchers are saved as *.session-handoff-original. Restart the client and any open shell after setup.
To configure one client only:
npx session-handoff@latest setup --client codex
npx session-handoff@latest setup --client claude
Use --yes for a non-interactive setup:
npx session-handoff@latest setup --client codex --yes
The client executable must already be on PATH. Without a client, setup stops with an error and changes nothing.
If a Codex update replaces the managed launcher while it is supervised, the supervisor restores it when Codex exits and keeps the updated executable as its target. Claude version updates are reconciled to the newest validated executable in its native versions directory. An installer run outside a supervised session cannot be repaired automatically; rerun setup afterward with --client codex or --client claude for the affected client.
The repository and npm package include native Claude and Codex plugin manifests, the portable plugin manifest, the command, the skill, hooks, and the MCP configuration.
This repository is not itself a marketplace. The published wrapper is yuzushi-plugins.
Claude Code:
/plugin marketplace add yuzushi-dev/yuzushi-plugins
/plugin install session-handoff@yuzushi
Codex:
codex plugin marketplace add yuzushi-dev/yuzushi-plugins
codex plugin add session-handoff@yuzushi
The marketplace path installs the plugin source from GitHub. The npm path above distributes the published package and managed setup independently.
After restarting the client:
Claude Code:
/session-handoff
Codex:
$session-handoff
Use migrate claude or migrate codex when you want to preserve the native session while changing clients. A normal handoff starts a clean session and keeps the implementation state in the handoff file.
Check the local setup without starting a model session:
npx session-handoff@latest doctor --pretty
Create mode writes handoffs under the workspace, usually in handoffs/. A clean repository does not need any project dependency or configuration file.
npx session-handoff@latest uninstall --yes
This restores the saved client launchers and removes the managed bundle and registrations.
Telemetry is off by default. An interactive npm install asks once. Marketplace installs show a non-blocking reminder at session start. See docs/telemetry.md for the data inventory and controls.