codex-jev-compaction
Codex plugin that builds handoff packets by asking Jev whether each old read-only tool record should stay, keeping retained text verbatim.
Overview
codex-jev-compaction prepares explicit handoffs for Codex: give it context blocks and it returns a traceable JSON or Markdown packet for the next task or session. It ships as a Codex plugin with a skill, a stdio MCP tool and a zero-dependency CLI.
Instead of a generated summary that can lose an exact constraint, path or error, it asks Jev a narrow question: should this old, verified read-only tool pair remain in the handoff? Jev returns classification probabilities; code decides which evidence is eligible, validates every answer, preserves protected content and builds the packet, keeping retained text verbatim and in order. The README is clear that selection is lossy and that this release does not replace Codex's native compaction, reclaim tokens in the current conversation or modify session files. It is inspired by fast-jev-compaction and has a Pi edition. Docs are in English and Chinese.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Yes / no | Should this old, verified read-only tool pair remain in the handoff? | yes · no |
How it works
- Provide explicit context blocks
- Code marks eligible evidence and protects required content
- Jev classifies each eligible tool pair
- Build a verbatim handoff packet
Strengths
- No rewriting; retained text is verbatim
- Protected content preserved by code
- Zero runtime dependencies
Caveats
- Lossy selection
- Does not affect the current conversation's tokens
Getting started
codex plugin marketplace add Wang-auspicious/codex-jev-compaction && codex plugin add codex-jev-compaction@codex-jev-compactionAt a glance
- Type
- Project
- Status
- beta
- Language
- JavaScript
- Runtime
- Codex plugin + MCP + CLI (Node 22+)
- Has code
- yes
- License
- MIT
Use cases and integrations
How curated lists describe it
Curates Codex handoff context by using Jev to select old tool records while retaining selected text verbatim.
logicrw/awesome-jev-projects
Frequently asked questions
Does it summarize?
No, it keeps selected text verbatim.
Does it compact the live conversation?
No, it prepares handoffs for the next task or session.
Is there a Pi version?
Yes, pi-jev-compaction.
Related projects
Pi extension where Jev judges each completed tool call and result before compaction, keeping key evidence verbatim in the summary.
PluginbetaTypeScriptLocal compaction proxy for Claude Code and Codex that compacts more often with local rules and keeps full history searchable.
ProxybetaGoPi observational memory where Jev answers keep/kind questions on history chunks, building a verbatim ledger and topic files.
ProjectbetaTypeScriptCodex port of fast-jev-compaction that re-injects Jev-selected verbatim history after compaction; the author advises against using it.
PluginprototypeTypeScriptOMP extension keeping one endless chat as a summary tree, with five Jev judge gates for rules, prefetch, compression, tools and recall.
PluginprototypeTypeScript- fast-jev-compaction★ 7,616
Claude Code plugin and npm library that replaces the compaction summary with Jev keep, truncate or drop scores for every tool call.
PluginbetaTypeScript