Skip to content
Metatext Decide — typed decisions for your agents, with a probability on every answerGet early access
Metatext
Sign Up

jev (Go client)

Provider-neutral Unix CLI for Jev: pipe state in, ask one Noul, Choice or Score question, get JSON out for scripts and CI.

Librarybeta
View on GitHub ↗

Overview

stefafafan/jev is an unofficial Unix command-line client for Jev written in Go, supporting TypeSafe, Cloudflare and Vercel as providers. State always comes from stdin, each invocation asks exactly one question through a noul, choice or score subcommand, and the answer is printed as JSON. The exit code reports whether evaluation succeeded, and the tool deliberately does not turn judgements into policy: thresholds go downstream, for example with jq.

Examples include piping a git diff to ask whether a change could introduce a regression, classifying a diff as safe, needs-review or unsafe, and scoring a kubectl diff for deployment risk. A companion setup-jev action installs the binary on GitHub Actions runners, and the repository's own workflow sends pull request diffs to Jev through Cloudflare and applies a merge-risk label.

What the decision model decides

TypeQuestionAnswers
Yes / noCould this change introduce a regression?—
ChoiceHow should this change be classified?safe · needs-review · unsafe
ScoreHow risky is this deployment?low · medium · high

How it works

  1. Pipe state into jev on stdin
  2. Choose a noul, choice or score subcommand with the question
  3. Read JSON output
  4. Apply thresholds downstream (for example jq) and act in CI

Strengths

  • Composable with shell pipelines
  • Provider-neutral
  • GitHub Actions setup available

Caveats

  • One question per invocation
  • Unofficial

Getting started

`go install github.com/stefafafan/jev@latest`, then `echo "some state" | jev --provider typesafe noul "Is this safe?"`.

At a glance

Type
Library
Status
beta
Language
Go
Runtime
CLI
Has code
yes

Use cases and integrations

How curated lists describe it

  • An unofficial, provider-neutral Unix client for Jev from TypeSafe AI. Written in Go.

    hellogumbo/awesome-jev

  • Provider-neutral Unix client: a question in, a typed answer out, for shells and scripts. `go install`.

    MrJev/awesome-jev

Frequently asked questions

How do I pass state?

Through stdin, for example piping a git diff.

Does it apply thresholds?

No, it outputs JSON; you threshold downstream.

Which providers work?

TypeSafe, Cloudflare and Vercel.

Related projects

  • typesafe-ai (Rust)

    Typed Rust client for System One with async reqwest or blocking ureq backends and observable retries.

    LibrarybetaRust
  • typesafe-jev-bridge

    Zero-dependency Node bridge that exposes Jev through an OpenAI-compatible API, plus a CLI, code-audit tool and auto-fix loop.

    CLIbetaJavaScript
  • ai

    Hack Club's lightweight LLM proxy, listed for adding a Jev forwarding endpoint behind its auth, limits and usage logging.

    MCP serverproductionTypeScript
  • Ax

    Ax, a DSPy-style multi-language LLM framework, listed with a native TypeSafe provider for Boolean, Choice, Score and raw Jev questions.

    PluginproductionTypeScript
  • Effect

    Effect TypeScript library whose @effect/ai-typesafe package maps classify, probability and rating operations to Jev questions.

    ProjectproductionTypeScript
  • instructor-php

    PHP monorepo whose Polyglot module adds a TypeSafe driver for typed Noul, Choice and Score decisions alongside LLM inference.

    ProjectproductionPHP