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

jev-cli

Small dependency-free CLI and stdio MCP server for Jev's noul, choice and score judgments over text or JSON.

MCP serverbetaMIT
View on GitHub ↗

Overview

jev-cli by tumf is a small command-line tool and stdio MCP server for TypeSafe Jev. You send text or JSON state, ask typed questions, and receive machine-readable noul, choice or score answers. The jev command suits application code that needs a fast classification or judgment instead of prose, and jev-mcp exposes the same judgments to MCP hosts.

Features include all three primitives, multiple questions in one request with run, input from text, JSON, files or stdin, compact JSON output by default, a value-only mode for shell scripts, structured stderr errors and meaningful exit codes. Per the MrJev list, auth set refuses a key passed as an argument to keep it out of shell history. It installs from PyPI with uv tool, giving both commands on PATH, uses the official TypeSafe API by default with TYPESAFE_API_KEY taking precedence over a credential file, and is at version 0.7.0. It is unofficial and MIT licensed.

What the decision model decides

TypeQuestionAnswers
Yes / noUser-defined yes/no questionyes · no
ChoiceUser-defined choice—
ScoreUser-defined score—

How it works

  1. Install with uv tool install jev-cli
  2. Authenticate via env var or hidden prompt
  3. Run jev with state and questions, or connect jev-mcp
  4. Use JSON output or value-only mode in scripts

Strengths

  • Same judgments in shell and MCP
  • Keeps keys out of shell history
  • Meaningful exit codes for scripting

Caveats

  • Unofficial
  • Requires Python 3.13+ (installed by uv)

Getting started

`uv tool install jev-cli`, `export TYPESAFE_API_KEY=...`, then `jev --version`.

At a glance

Type
MCP server
Status
beta
Language
Python
Runtime
CLI, stdio MCP server
Has code
yes
License
MIT

Use cases and integrations

How curated lists describe it

  • Developer tooling: small dependency-free CLI for Jev.

    yibie/awesome-jev

  • A CLI and stdio MCP server for typed Jev judgments over text or JSON.

    logicrw/awesome-jev-projects

  • Small dependency-free CLI for TypeSafe Jev.

    hellogumbo/awesome-jev

  • CLI and stdio MCP server for the three Jev primitives, with `--value` for shell scripts and structured stderr errors. `auth set` refuses a key as an argument, keeping it out of shell history.

    MrJev/awesome-jev

Frequently asked questions

What does jev-cli provide?

A CLI and MCP server for Jev's three primitives.

Can I use it in shell scripts?

Yes, with value-only output and meaningful exit codes.

How is the key stored safely?

Via environment variable or a hidden prompt; it refuses keys passed as arguments.

Related projects

  • jev-mcp (freepik-company)

    Go MCP server giving any client typed Jev decisions via OpenRouter or TypeSafe, with validated answers and no paid retries.

    MCP serverproductionGo
  • askjev

    Unofficial hosted or local Jev MCP server giving agents a quick second opinion: it picks yes/no, scale or choice and returns probabilities.

    MCP serverbetaTypeScript
  • jev (shaharia-lab)

    Rust CLI for Jev: ask yes/no, choice and rubric questions about text and branch on exit codes, JSON or MCP tools.

    MCP serverbetaRust
  • Jev Studio

    pip-installable Jev kit: a CLI for verify, screen, classify, extract, route and rerank, plus an MCP server for the primitives.

    MCP serverbetaPython
  • jev-acp

    Agent Client Protocol agent that exposes Jev Choice, Score and Noul decisions in IDEs with guided input and probability displays.

    ProjectbetaTypeScript
  • jev-judge

    Dependency-free CLI and Codex skill that send local state to Jev for typed judgments and return answers without echoing the state.

    Agent skillbetaPython