jev-gateway

# jev-gateway

A local LLM gateway for coding agents. When your agent is about to decide **which tool to call**,
the gateway asks [Jev](https://docs.typesafe.ai/introduction), TypeSafe's fast decision model,
instead of leaving that choice to the expensive reasoning model. Everything else goes to your usual
LLM untouched.

It works with **Codex**, **Claude Code** and **OpenCode** out of the box, including on ChatGPT and
claude.ai subscriptions, with Gemini API clients, and with any client that speaks the OpenAI,
Anthropic or Google Gemini APIs.

> Independent project, not affiliated with or endorsed by TypeSafe. "Jev" is TypeSafe's model and
> this gateway is a client of its public API.

## Quick start

You need Node.js 22.15 or newer, a key for Jev (from TypeSafe, OpenRouter or Vercel AI Gateway, see
[Where Jev runs](#where-jev-runs)), and Codex, Claude Code, and/or OpenCode already installed and
logged in.

**1. Install**

```bash
npm install -g jev-gateway
```

**2. Run your agent through the gateway**

```bash
jev-codex      # use it exactly like `codex`
jev-claude     # use it exactly like `claude`
jev-opencode   # use it exactly like `opencode` (stable v1)
jev-gemini     # Gemini CLI, with a Gemini API key
```

**3. Answer two questions, once**

The first time, the launcher asks where you want to reach Jev and for the key. It checks the key
with one real call, saves it to `~/.jev-gateway/.env` (readable only by you), and carries on into
your agent. Every `jev-` command shares that file, so you are asked once for all of them.

```text
Where do you want to reach Jev?
  1) TypeSafe: the official API, direct from the makers of Jev
  2) OpenRouter: Jev through your OpenRouter account and credits
  3) Vercel AI Gateway: Jev through your Vercel AI Gateway key and billing