Skip to content

Add Jevonian (local routing proxy deciding with Jev) - #75

Closed
xinyao27 wants to merge 1 commit into
hellogumbo:mainfrom
xinyao27:add-jevonian
Closed

xinyao27 wants to merge 1 commit into
hellogumbo:mainfrom
xinyao27:add-jevonian

Conversation

@xinyao27

@xinyao27 xinyao27 commented Sep 21, 2026 •

Copy link
Copy Markdown
Contributor

What this adds

  • Jevonian — xinyao27/jevonian, a local proxy that sits between a coding agent and its model providers and puts each turn to Jev to pick the route.

How it uses Jev

Jevonian serves an OpenAI/Anthropic/Responses-compatible endpoint on http://127.0.0.1:8787/v1. For jevonian/auto, one Jev call answers both which candidate model and how deeply to think, chosen from a state snapshot built from the session (last user message, recent messages and tool results, consecutive error count, context headroom, quota health, candidate capabilities, and cache-switch penalties). Deterministic code narrows the candidate list first — wire protocol, context window, thinking-level floor, and spent quota windows are plain arithmetic, never model judgement.

The four typesafe, openrouter, vercel, and opencode-zen Jev channels live in src/brain.ts (https://api.typesafe.ai/v1/systemone, typesafe/jev-1.13). minConfidence turns a low-confidence answer into a marked low-confidence turn in the ledger and response headers rather than a silently accepted route; secondary channels are only tried when the primary channel fails. Explicit routes (jevonian/plan, /execute, /utility, /chat) bypass Jev entirely, and routing.mode: "off" is pure pass-through.

Why it is interesting

Two things other entries in this section do not cover:

  • Jev decides cost, not just the action. The value it optimises is dollars and cache affinity across providers, and every decision is recorded with the model that actually served the turn, the reason, real token usage, cache reads, and an estimated cost in a local ledger — so the Jev answer is auditable after the fact.
  • Quota-aware candidates. Providers that have spent their window are removed before Jev is asked, and unknown quota is treated as neutral rather than as a blocker, so a spent subscription moves work instead of failing the turn.

The routing state and wire protocol for each Jev channel are documented in docs/brain.md.

Disclosure

I maintain Jevonian. v0, TypeScript, AGPL-3.0-only, published to npm as jevonian. One project, one PR; this changes only data/projects.json and passes npm run validate.

site is the npm package page rather than a homepage, since the product is the local server itself.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Summary by CodeRabbit

  • New Features
    • Added Jevonian to the projects directory.
    • Listed as a TypeScript agent tool providing a local OpenAI-compatible proxy that dynamically selects the routed model and thinking level for coding agents.
    • Included project metadata such as its repository, category, and current popularity indicators.

@coderabbitai

coderabbitai Bot commented Sep 21, 2026 •

Copy link
Copy Markdown

Review Change StackReview Change Stack

Understand this PR’s impact

Explore downstream dependencies and potential security impact with Blast Radius.

View blast radius →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: d604d613-9f0c-43bf-af5e-fe027c9780b6

📥 Commits

Reviewing files that changed from the base of the PR and between 931021f and e385de1.

📒 Files selected for processing (1)
  • data/projects.json

Included review availability: Your plan provides up to 2 included reviews per hour; 1 remains after this review.


📝 Walkthrough

Walkthrough

The project catalog adds Jevonian, a TypeScript local OpenAI-compatible proxy, under the agents category with repository, description, star, and date metadata.

Changes

Project catalog

Layer / File(s) Summary
Add Jevonian project entry
data/projects.json
Adds the Jevonian repository with its category, language, description, star count, and added date.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Feature

Suggested reviewers: scald

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description check ✅ Passed The description explains the project, how Jev fits, validation status, changed files, and maintainer relationship. It does not reproduce the template headings or checkboxes, but it provides the requir…
Title check ✅ Passed The title clearly identifies the primary change: adding Jevonian and describing its local routing function.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create a new PR

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

scald pushed a commit that referenced this pull request Sep 24, 2026
@scald

scald commented Sep 24, 2026

Copy link
Copy Markdown
Contributor

Landed on main as dde8d32 with you as the commit author, now live on https://awesomejev.com. Closing rather than merging because every PR appends to the same data file and they conflict with each other; landing directly keeps your authorship. Thanks!

@scald scald closed this Sep 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants