<div align="center">

optim-jev

Spend fewer tokens in long Claude Code sessions—without changing how you work.

Jev-powered context compaction, model routing, and skill selection in one Claude Code plugin.

Get started · Documentation · Architecture · Contributing

<img src="assets/demo.gif" alt="optim-jev demo in Claude Code" width="100%"> </div>

Why optim-jev?

<img src="assets/optim-jev.png" alt="optim-jev architecture: context compaction, model routing, and skill selection" width="100%">

Long agent sessions accumulate stale tool output, send oversized skill catalogs, and use the main model for work a smaller model could handle. optim-jev reduces that overhead at three points while keeping Claude Code's normal workflow intact.

Each tool works independently, fails open if unavailable, and includes a stats command that reports session-level cost and savings in US dollars.

Three tools, one plugin

| Tool | What it does | Default | Learn more | |---|---|:---:|---| | jev-compacter | Removes stale tool calls and outputs instead of summarizing away the whole conversation | On | Guide | | jev-router | Routes file changes to the right model using project-specific rules that evolve with your workflow | Off | Guide | | jev-skills | Sends a short, relevant skill list for each prompt instead of the entire catalog | Off | Guide |

<details> <summary><strong>jev-compacter — preserve useful context</strong></summary> <br> <img src="assets/jev-compacter.png" alt="jev-compacter session statistics" width="100%">

It works automatically with /compact and auto-compaction. Inspect the current session with:

/jev-compact stats

</details> <details> <summary><strong>jev-router — use the right model for each edit</strong></summary> <br> <img src="assets/jev-router.png" alt="jev-router model routing decisions" width="100%">

/jev-route init "what matters in this project"
/jev-route on | off
/jev-route why | stats

Tell Claude to change a preference later—for example, “let haiku edit the tests”—and the project rules update with your workflow.

</details> <details> <summary><strong>jev-skills — load only relevant skills</strong></summary> <br> <img src="assets/jev-skills.png" alt="jev-skills prompt shortlist" width="100%">

/jev-skills on | off
/jev-skills scope project | global
/jev-skills why | stats | reindex

</details>

Quick start

Requirements

• Claude Code with plugin support
• Python 3.10 or newer
• A TypeSafe API key for Jev

Install

git clone https://github.com/Oqura-ai/optim-jev.git
claude plugin marketplace add ./optim-jev
claude plugin install optim-jev@optim-jev

Set the key in Claude Code under /config → TypeSafe API key, or export it before starting Claude Code:

export TYPESAFE_API_KEY="your-key"

Restart Claude Code. jev-compacter is ready immediately; enable the router and skill picker when you want them. See Getting started for every command, option, and troubleshooting step.

[!NOTE] The plugin uses only Python's standard library. Your API key is passed to child processes through the environment and is never written to project files or logs.

Documentation

| Resource | What you will find | |---|---| | Getting started | Installation, configuration, commands, and troubleshooting | | TinyCart demo | A short, repeatable showcase of all three tools on a toy project | | Performance metrics | How token usage, cost, and estimated savings are calculated | | Architecture | The TypeScript-to-Python bridge, data flow, and session logs | | Contributing | Local setup, tests, conventions, and pull requests |

Community and support

• Found a bug or have a feature idea? Open an issue.
• Want to help? Read the contributing guide and submit a focused pull request.
• For the wider Claude Code community, join the official Claude Developers Discord.

License

optim-jev is released under the MIT License.

<div align="center">

Built by Oqura.ai for more efficient Claude Code workflows.

</div>