Skip to content

r-design-j/codex-session-continuity-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Codex Session Continuity Skill

session-continuity is a Codex skill for file-backed cross-session handoff and resume.

It turns the manual loop of "summarize the current conversation, open a new session, paste the summary" into a validated checkpoint, bootstrap, and optional new-thread workflow.

What It Does

  • Writes authoritative continuity state under .agent/continuity/.
  • Creates full-session checkpoints and targeted handoffs.
  • Generates bootstrap prompts for new Codex sessions.
  • Validates hashes, redaction, active writer locks, and tri-party review evidence.
  • Integrates with Codex + Claude + Gemini workstreams without replacing their review artifacts.
  • Provides a global sc shortcut for daily use.

Repository Layout

session-continuity/
  SKILL.md
  agents/openai.yaml
  references/
  scripts/

Install

mkdir -p ~/.codex/skills
cp -R session-continuity ~/.codex/skills/
mkdir -p ~/.npm-global/bin
ln -sf ~/.codex/skills/session-continuity/scripts/sc ~/.npm-global/bin/sc
ln -sf ~/.codex/skills/session-continuity/scripts/sc ~/.npm-global/bin/session-continuity
ln -sf ~/.codex/skills/session-continuity/scripts/sc ~/.npm-global/bin/codex-continuity

Make sure ~/.npm-global/bin is on your PATH.

Quick Start

From any project or workstream root:

sc save "latest user request" "active goal" "next task"
sc v
sc b
sc h

Targeted handoff:

sc target "target name" "target summary" "next task"
sc v --target "target name"
sc b --target "target name"
sc h --target "target name"

Self-test:

sc test

Codex Slash Palette

After installation, open a fresh Codex session if needed, type /, and choose Session Continuity.

The default prompt asks Codex to checkpoint the current workspace, create a new Codex thread when thread tools are available, and report the new thread link.

Validation Gates

Every resume must pass or explicitly label:

  • probe_status
  • redaction_status
  • hash_status
  • review_status
  • bootstrap_status

Hard failures such as hash mismatch, suspected secrets, or active writer locks should stop the resume.

License

No license has been selected yet.

About

Codex skill for file-backed cross-session handoff and resume

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors