User repository on GitHub
Codex plugin that preserves useful conversation excerpts alongside the summary after context compaction.
- Forks
- 0
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.
CommunityJev Agents & MCP
Jevkeep
A Codex plugin that asks Jev which conversation passages still matter, lets Codex compact normally, then restores the selected excerpts verbatim afterwards with labels for their original role and tool source.
- Stars
- 1
- Language
- TypeScript
- License
- MIT
- Published by
- Community
- Author
- hatt-io
- Last verified
- Oct 2026
About this project
A Codex plugin that preserves useful conversation excerpts alongside the summary after context compaction. When a conversation gets long, Codex condenses earlier messages into a summary to make room for more work. That summary can lose exact details: a command that failed, a file path, an error message, or a constraint you gave earlier.
Quoted from the project's README. Read the full README.
Works forJev for Classification
Used inJev for Software & DevTools
- Languages
- TypeScript
Highlights
- It wraps Codex's own compaction: Jev scores relevance before, Codex summarizes as usual, excerpts come back after, so manual and automatic both work.
- Restored text stays verbatim, each packet is capped at 24,000 UTF-8 bytes, and trimmed excerpts carry an explicit omission marker.
- Conversation text, tool inputs and textual tool results go to the Typesafe API on jev-latest; reasoning records and binary content are excluded.
- Missing credentials or a failed scoring pass are non-events: native compaction continues and stale excerpts are discarded, not restored.
Watch out
It preserves selected excerpts, not the whole conversation, and relevance scoring can miss something you need later, at the cost of extra API requests and time on every compaction, with a shared 20-second network deadline inside a 30-second hook timeout. Excerpts belong to one session and transcript, and if Codex's transcript format changes the plugin skips preservation and leaves native compaction running. Setup has sharp edges: Node 22+ must be on the PATH Codex actually uses including desktop launches, hooks must be trusted manually in /hooks since installing the plugin does not enable them, and the key comes from the environment or a 700 directory holding a 600 file that must not be a symlink. Conversation text, which can include source code, leaves the machine on each scored compaction. Copy reviewed against the repository README on 2026-10-04, not from running it.
Questions about this entry
Short answers drawn from the linked project or page.
Yes, and the README is specific. JevKeep sends conversation text, tool inputs and textual tool results to the Typesafe API endpoint on the jev-latest model, and that text can include source code and other material shown to Codex. Reasoning records and structured binary content are excluded. Selected excerpts are stored locally in private files under Codex's plugin data directory, the transcript is read without being modified, and the diagnostics contain neither API keys nor conversation contents.
Compaction proceeds normally. If credentials are missing or scoring fails, the plugin steps aside and Codex's own compaction continues, so the failure mode is losing excerpt preservation rather than losing the conversation. The preserved text itself stays verbatim, though large excerpts may keep only the beginning and end with an explicit omission marker, and each restored packet is limited to 24,000 UTF-8 bytes.
Saved excerpts are scoped to one session and transcript, and invalid or stale state is discarded rather than restored into the wrong conversation. That constraint is also why an unsupported transcript format is treated as a skip instead of an attempt: if Codex's format changes, preservation is bypassed and native compaction runs untouched.
The idea and the original implementation come from tamaratran's fast-jev-compaction, built for Claude Code; JevKeep adapts it for Codex and reuses unmodified MIT-licensed library files from a pinned commit for request construction, response parsing, token estimates and context budgeting, with the upstream licence preserved. Codex transcript parsing, excerpt selection, hook integration and local persistence are implemented in this repository. The runtime is bundled into the committed build, so installation needs no npm install or compile step.
Node 22 or newer on the PATH Codex uses, including desktop launches, plus the Codex CLI with plugin and compaction-hook support. Clone, run node scripts/install.mjs, then codex plugin add jevkeep@personal; the runtime is bundled so there is no npm install or build step. Then open /hooks in Codex and trust the two hooks manually, because installing the plugin alone does not enable them. A new conversation is required afterwards.
Two routes. For the CLI, set TYPESAFE_API_KEY in the environment where you launch Codex. For the desktop app, save it in ~/.config/jevkeep/config.json, where on macOS and Linux the directory must be 700 and the file 600, owned by your user and not a symlink. The environment variable takes precedence over the file, and credentials belong outside the repository and plugin folder.
Extra API requests and time, and the numbers are bounded. Scoring has a shared 20-second network deadline inside a 30-second hook timeout. Restored packets are capped at 24,000 UTF-8 bytes each, and oversized excerpts keep only the beginning and end with an explicit omission marker, so the text stays verbatim where it is shown at all.
More Jev resources like this
48GitHub stars
Agent harness for work that outlives one chat, with resumable turns, routed state machines, and observational memory across sessions and processes.
Jev Agents & MCP#community#jevbest#catalog-import
Community
dzhng/duet-agentTypeScript
dzhng/duet-agentTypeScript37GitHub stars
Assistant framework that stores specs, memory, and specialist agents as plain markdown files in your repo for Claude Code, Codex, Opencode, and similar runtimes.
Jev Agents & MCP#community#jevbest#catalog-import
36GitHub stars
Obsidian plugin providing multi-provider chat, vault read and write with function calling, visual workflow automation, and local vector search.
Jev Agents & MCP#community#jevbest#catalog-import
Community
takeshy/obsidian-llm-hubTypeScript
takeshy/obsidian-llm-hubTypeScript36GitHub stars
Pi extension that strips the full Agent Skills catalog from every request and loads only the skills a Jev ranking call judges relevant.
Jev Agents & MCP#community#jevbest#catalog-import
102GitHub stars
Behavioral code search that asks Jev to score repository fragments for a plain-language question and returns exact excerpts with paths and lines.
Jev Agents & MCP#community#jevbest#catalog-import
Community
nassim-arifette/jevgrepTypeScript
nassim-arifette/jevgrepTypeScript44GitHub stars
Pi extension that keeps a fast Executor model on implementation and brings in a separate Advisor model for consequential choices and reviews.
Jev Agents & MCP#community#jevbest#catalog-import
Community
philipbrembeck/pi-advisorTypeScript
philipbrembeck/pi-advisorTypeScriptFrom the Jev community
Posts from builders shipping with Jev right now.