Oqura-aiJev based decision tools for claude code
Jev based decision tools for claude code
·
optim-jev
Spend fewer tokens in long agent sessions without changing how you work.
Jev-powered optimization for Claude Code, plus model routing for OpenAI Codex.
Get started · Codex support · Documentation · Architecture · Contributing
Why optim-jev?
Long agent sessions accumulate stale tool output, send oversized skill catalogs, and use the main model for work a smaller model could handle. Claude Code supports all three optimizers below. Codex supports the model router and an off-by-default advisory skill experiment.
Each tool works independently and fails open if unavailable. Measured cost reports remain Claude-only.
Three tools, one project
| Tool | What it does | Available in | Claude default | Learn more |
|---|---|---|---|---|
| jev-compacter | Removes stale tool calls and outputs instead of summarizing away the whole conversation | Claude Code | On | Guide |
| jev-router | Routes file changes to the right model using project-specific rules that evolve with your workflow | Claude Code and Codex | Off | Guide |
| jev-skills | Sends a short, relevant skill list for each prompt instead of the entire catalog | Claude Code; experimental advisory mode in Codex | Off | Guide |
jev-compacter — preserve useful context
It works automatically with /compact and auto-compaction. Inspect the current session with:
/jev-compact statsjev-router — use the right model for each edit
/jev-route init "what matters in this project"
/jev-route on | off
/jev-route why | statsTell Claude to change a preference later—for example, “let haiku edit the tests”—and the project rules update with your workflow.
jev-skills — load only relevant skills
/jev-skills on | off
/jev-skills scope project | global
/jev-skills why | stats | reindexClaude Code 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-jevSet 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.
OpenAI Codex support — new
Start with the complete Codex guide for installation, usage, model-tier setup, verification, limitations, troubleshooting, and uninstall steps.
optim-jev can automatically route each Codex subagent to an account-specific fast, balanced, or
strong model. It also selects reasoning effort, applies project path rules, escalates after
failures, and can provide an optional advisory skill shortlist. Claude and Codex keep separate
model catalogues, policies, caches, and logs.
[!IMPORTANT] Compaction is not supported in Codex. Codex hooks cannot replace live conversation history. The AbovePrompt dashboard, slash commands, and measured token and cost reports are also Claude-only.
Install and use
Codex CLI 0.162.1 or newer can install optim-jev directly from GitHub. No PyPI release or manual clone is required.
py -3 -m pip install "https://github.com/Oqura-ai/optim-jev/archive/refs/heads/main.zip"
optim-jev codex install
$env:TYPESAFE_API_KEY = "your-key"
cd C:\path\to\your-project
optim-jev codex setup
optim-jev codex status
codexOn the first Codex launch after install or update, run /hooks, review and trust every optim-jev
hook, then restart Codex.
Inside Codex, subagent routing is automatic. Check the most recent decision or control project features with:
!optim-jev codex why
!optim-jev codex status
!optim-jev codex on
!optim-jev codex off
!optim-jev codex skills-on
!optim-jev codex skills-offDocumentation
| Resource | What you will find |
|---|---|
| Getting started | Installation, configuration, commands, and troubleshooting |
| Codex support | Codex installation, router setup, configuration, and limitations |
| 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.
Built by Oqura.ai for more efficient coding-agent workflows.
This repo does not document an install step we could read. Check the README on GitHub.
Install with your agent
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/optim-jev to learn what the "Optim Jev" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
What's missing
- Installation methodRequiredThe README documents at least one way to install or connect.0/15
- Easy installA paste-ready client config (an mcpServers block) is documented.0/12
- Claimed by ownerThe maintainer proved ownership of this listing.0/4
All 5 checks (2 passed)
- Installation methodRequiredThe README documents at least one way to install or connect.0/15
- Has a READMERequiredThe repository ships documentation we could read.10/10
- Easy installA paste-ready client config (an mcpServers block) is documented.0/12
- Has a licenseThe repository declares a license.8/8
- Claimed by ownerThe maintainer proved ownership of this listing.0/4
- Verified liveNot checkableWe connected to the server and it answered a real MCP handshake.—
- Exposes toolsNot checkableThe server reports at least one tool, from its manifest or a live read.—
- Ships promptsNot checkableThe server exposes at least one prompt template.—
- Ships resourcesNot checkableThe server exposes at least one resource.—
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingShow this grade in your README
Paste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/optim-jev)Alternatives to Optim Jev
Nothing comparable is listed yet.
No tagged releases on record.
Send this prompt to your agent to leave a review
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "optim-jev" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
Subscribe to our newsletter
One email a week. New agents, MCP servers and skills, and what is actually getting traction.