@lucianogalvao/turn-shift
v0.2.1
Published
Install Turn Shift skills for moving work between Codex and Claude sessions.
Maintainers
Readme
Turn Shift
Turn Shift installs local agent skills that let Codex and Claude recover recent work from each other's session logs.
Install
Use the package directly:
npx @lucianogalvao/turn-shift@latest install codex
npx @lucianogalvao/turn-shift@latest install claudeOr install the CLI globally:
npm install -g @lucianogalvao/turn-shift@latest
turn-shift install codex
turn-shift install claudeUpdate
After a new package version is published, update the installed local skills from the latest npm package:
npx @lucianogalvao/turn-shift@latest update codex
npx @lucianogalvao/turn-shift@latest update claudeIf you use the global CLI, update the global package first, then update the local skill install:
npm install -g @lucianogalvao/turn-shift@latest
turn-shift update codex
turn-shift update claudeWhat Gets Installed
For Codex:
~/.agents/skills/turn-shiftFor Claude:
~/.claude/skills/turn-shiftThe npm package does not use postinstall and does not modify agent directories unless you run the install command explicitly.
Usage
In Codex, mention the installed skill with $turn-shift to read Claude Code sessions:
$turn-shift claude
$turn-shift claude -m "message text"
$turn-shift claude <session-hash>
$turn-shift claude --session <session-hash>In Claude, use the installed skill to read Codex sessions:
/turn-shift codex
/turn-shift codex -m "message text"
/turn-shift codex <session-hash>
/turn-shift codex --session <session-hash>When multiple sessions match a message search, Turn Shift lists up to three candidates with a title, summary, session hash, source, and match excerpt. After that list appears, run again with the candidate number to load that result:
$turn-shift 1
/turn-shift 1You can also load a specific session directly with the provider plus session hash, or provider plus --session <hash>.
Development
npm test
npm run pack:dryPython scripts can be syntax-checked with:
PYTHONPYCACHEPREFIX=/tmp python3 -m py_compile skills/codex/scripts/turn_shift.py skills/claude/scripts/turn_shift.pySecurity
Turn Shift reads local agent session logs. Review output before sharing it publicly because transcripts may include file paths, commands, errors, prompts, and other private context.
