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**, **OpenCode** and **Kilo** 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, Vercel AI Gateway or
OpenCode, see [Where Jev runs](#where-jev-runs)), and Codex, Claude Code, OpenCode, Kilo and/or
Devin 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-kilo       # Kilo CLI, on free models unless KILO_API_KEY is set
jev-gemini     # Gemini CLI, with a Gemini API key
jev-devin      # use it exactly like `devin`
```

**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 o