The original session stays put
Free scans read-only. It does not rewrite the transcript or upload attachments.
02AI CONTEXT UTILITY
Context Offload
Keep the work. Drop the payload.
When native compaction leaves screenshots, PDFs, or Base64 payloads in active history, Context Offload finds the real burden and prepares a clean handoff without changing your original session.
Free and open sourceCodex + Claude Codev0.4.0-alpha
Only the working context moves
Goal, decisions, verified state, and one next action become a bounded handoff.
03 / INSTALL
Install into both Skill hosts with one command
The pinned alpha installs Context Offload into the personal Skill directories for Codex and Claude Code. Everything runs locally and the Free edition remains read-only.Install into both Skill hosts with one command
npx --yes github:zdayang/context-offload-free#v0.4.0-alpha --platform allLocal processing only
Original session stays unchanged
No account or backend
04 / WORKFLOW
A clean exit from a bloated session
Free does not pretend to recover tokens already spent. It prevents the old attachment history from following your next piece of work.- 01
Scan the active history
Detect only large inline images and documents that the host will reconstruct, then report bounded IDs, types, sizes, and occurrences.
- 02
Prepare the handoff
Capture the current goal, decisions, verified project state, open risks, and exactly one next action without copying raw payloads.
- 03
Continue cleanly
Start a fresh session in the same project, provide the bounded handoff, and confirm it understands the goal before archiving the old thread.
05 / SAFETY
Useful because it stays boringly safe
Session transcripts can contain private files, credentials, and untrusted instructions. The Free edition keeps a deliberately narrow boundary.- 01
No transcript, attachment, or Base64 payload is uploaded.
- 02
Raw JSONL and attachment bytes never enter model context or command output.
- 03
Unknown, invalid, cyclic, or incomplete session structures fail closed.
- 04
The tool reports encoded payload size, not invented token savings.
06 / EDITIONS
Two editions. One safety boundary.
A complete free solution
Diagnose the active burden and continue through a bounded new-session handoff. The original transcript remains untouched.
View on GitHubSame-session convenience
Pro is a separate private alpha for verified backup and automatic cleanup when preserving the same thread matters. It is not included in the public repository.
Private alpha07 / GET STARTED