What is codex-jev-compaction?

A Codex plugin for Jev-powered context handoffs. Give it explicit context blocks — including old, verified read-only tool pairs — and it returns a traceable JSON or Markdown packet for the next task or session.

How does Jev participate in the handoff?

It answers one narrow classification question per candidate tool pair: should this old, verified read-only pair remain? Jev returns classification probabilities; code decides which evidence is eligible, validates every answer and preserves protected content.

How do I install the plugin?

Run codex plugin marketplace add Wang-auspicious/codex-jev-compaction, then codex plugin add codex-jev-compaction@codex-jev-compaction. Add --ref v0.1.0 to pin a release; a local checkout works too, pointing Codex at the repo root with .agents/plugins/marketplace.json.

What happens without a TypeSafe API key?

Missing keys are supported: the tool returns the original blocks with an explicit reason and sends nothing to Jev. For live selection, set TYPESAFE_API_KEY in the environment that launches Codex and open a new Codex task afterwards.

Does it replace Codex's automatic compaction?

No. This release prepares explicit handoffs only: it does not replace Codex native automatic compaction, reclaim tokens in the current conversation, or modify Codex session files, per the README.

What are the requirements to run it?

Node.js 22+ on PATH, a Codex CLI with the codex plugin command, and a TypeSafe API key for live selection. There is no build step and no runtime npm dependencies; local acceptance used Codex CLI 0.153.4 on Windows.

What are the limits of this approach?

Selection is lossy: removed evidence is absent from the packet, and a classifier can be wrong, so the README says to keep the original input as the authoritative archive. The captured README was truncated before any full measured-results section.

Jev directory

CommunityJev Agents & MCP

Codex Jev Compaction

A Codex plugin that prepares traceable context handoffs: Jev answers one narrow classification question per old, verified read-only tool pair, and code validates the answers, preserves protected content and builds a JSON or Markdown packet.

See highlights Open github.com

Stars: 4
Language: JavaScript
License: MIT
Reading time: 2 min
Published by: Community
Author: wang-auspicious
Last verified: Oct 2026

wang-auspicious/codex-jev-compaction

User repository on GitHub

View on GitHub

Jev-powered context curation for Codex. Build compact, traceable handoff context through native plugins and skills.

Forks: 0
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.

Tagscommunity catalog-import logicrw codex context

Works forJev for Decision gating Jev for Tool calling Jev for Classification

Used inJev for Software & DevTools

Languages: JavaScript
Platforms: MCP CLI
Capabilities: Open sourceRequires API key

Highlights

A Codex plugin with a skill, an MCP tool (server jev_context, tool curate_context) and a zero-dependency CLI; no runtime npm dependencies.
Jev answers one question per old, verified read-only tool pair — should it remain in the handoff? — while code decides eligibility.
Retained source text stays verbatim and in order; selection is lossy, so the README says keep the original input as the authoritative archive.
Missing API keys are supported: the tool returns the original blocks with an explicit reason and sends nothing to Jev.
Does not replace Codex's native automatic compaction, reclaim tokens in the current conversation, or modify Codex session files.

Quickstart

bash

codex plugin marketplace add Wang-auspicious/codex-jev-compaction
codex plugin add codex-jev-compaction@codex-jev-compaction

Watch out

Copy reviewed against the truncated repo README on 2026-10-15; the capture ends inside the MCP tool section, so the CLI surface and measured results were not reviewed. The README reports local host acceptance on Codex CLI 0.153.4 on Windows and credits tamaratran/fast-jev-compaction as inspiration.

Questions about this entry

Short answers drawn from the linked project or page.

Reactions & coverage

Posts, threads, and videos about this entry from around the web.

X: Jev Day recap: four times the context and the danger zone

From the Jev guides

Original write-ups on what this entry is for.

MCP tool routing: Jev in front of the tool call

Oct 16, 2026

Tool menus can outgrow the context that reads them. The catalog's Jev-based routers and gates narrow the list: benchmarked tool search, per-tool scoring, fail-closed approvals, and WebMCP in the browser.

Jev Agents & MCP#mcp#tool-routing#agents

Read article

Approval policies for coding agents: hooks, guards, and gateways