ChatGPT Auto Handoff

A skills-only plugin for ChatGPT Desktop and Codex that helps long-running conversations survive context pressure without pretending an exact token threshold API exists.

What it does

• Maintains concise rolling state after material decisions, changes, validations, and blockers.
• Generates a complete handoff package before continuity degrades.
• Includes goals, paths, environment, current state, completed work, decisions, constraints, recent changes, verification, remaining tasks, known issues, next step, and a recovery prompt.
• Produces separate long-term memory candidates and rejects temporary logs, one-off errors, secrets, and unsupported inferences.
• Uses real host context or compaction signals when available; otherwise labels size-based triggering as heuristic.

What it cannot do

• It cannot read an undocumented exact per-chat token percentage.
• It cannot guarantee that the host will invoke a Skill on every turn.
• It cannot unconditionally create and migrate every type of ChatGPT chat.
• In an ordinary Chat without a writable workspace, it cannot claim that an external rolling-state file exists.

Install from GitHub

After this repository is published:

codex plugin marketplace add lenlanF/chatgpt-auto-handoff
codex plugin add chatgpt-auto-handoff@chatgpt-auto-handoff

Restart ChatGPT Desktop and start a new chat so the plugin is loaded.

For the same always-on behavior, copy the contents of GLOBAL-INSTRUCTIONS.md into ChatGPT Desktop Settings → Personalization → Custom instructions. In Codex-compatible local environments, the same text can be placed in the global AGENTS.md file.

Install from a local clone

git clone https://github.com/lenlanF/chatgpt-auto-handoff.git
cd chatgpt-auto-handoff
codex plugin marketplace add .
codex plugin add chatgpt-auto-handoff@chatgpt-auto-handoff

Use

Automatic discovery is enabled. For an explicit checkpoint, ask:

Use Auto Handoff to prepare a complete recovery package for a fresh chat.

Workspace-backed tasks store state at .codex/auto-handoff/state.json. Ordinary Chat sessions keep a compact logical checkpoint in conversation context and emit the package when triggered.

Development

Run validation from the repository root:

python -m unittest discover -s tests -v
python C:\path\to\quick_validate.py plugins\chatgpt-auto-handoff\skills\auto-handoff
python C:\path\to\validate_plugin.py plugins\chatgpt-auto-handoff

The plugin contains no network service, authentication, or telemetry.

License

MIT