When do I use the root command versus the scalar shortcuts?

Use the root jev command with --state and --questions for one parallel call returning model, answers, and usage. Use the scalar subcommands when a script only needs a label, a yes probability, or a weighted score on stdout.

Why does the CLI reject my flags before calling the API?

Pass exactly one of --state, --state-file, --text, or --stdin; prompts need exactly one of --prompt or --prompt-file, and choice or score alternatives need exactly one of their value or file flags. Anything else exits before any API call.

How do I check a question file without spending tokens?

Add --dry-run to print the exact SDK request without network access. Output stays request JSON regardless of --format, which is useful for checking question maps, files, and criteria before spending tokens.

Which output format composes best with shell pipelines?

Value prints one newline-terminated scalar for composition, json prints the typed answer with probabilities and confidence, and response prints the full SDK payload. The root command always prints the complete response.

How do I install it and where does the API key come from?

Bun and a TypeSafe API key are the only requirements. Install with npm install --global @andrueandersoncs/jev-cli, or call npx @andrueandersoncs/jev-cli for one-off use, and export TYPESAFE_API_KEY or drop it in a .env file in the directory you run jev from, which Bun loads automatically.

What does a real answer look like on the wire?

The root command returns model, answers keyed by your own question ids, and usage with input and output token counts. A noul prints the probability of yes from 0 to 1, and a score prints a zero-indexed probability-weighted level that can land between two levels, such as 1.10 across three levels.

What is it built on, and which SDK version is pinned?

Effect CLI v4 handles arguments and generates per-command help, over @typesafe-ai/sdk 0.6.x with effect and @effect/platform-bun 4.0.0-rc.117. The SDK uses its default model, currently jev-latest, and that alias moves, so pin it yourself if reproducibility matters.

CommunityJev Tools & CLIs

Jev CLI — andrueandersoncs

Bun CLI for Jev judgments: evaluate a mixed question map in one call at the root, or use choice, noul, and score shortcuts that print shell-friendly scalar values.

See highlights

Open github.com

Stars: 1
Language: HTML
License: MIT
Published by: Community
Author: andrueandersoncs
Last verified: Oct 2026

andrueandersoncs/jev-cli

User repository on GitHub

View on GitHub

Ask TypeSafe AI typed questions about JSON state from the command line

Forks: 0
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.

This is one of several Jev listings for the same project. The canonical entry is Jev CLI — shaharia-lab.

About this project

A Bun CLI for asking TypeSafe AI typed questions about JSON or plain-text state. The root command evaluates an API-shaped map of mixed questions in one request; choice, noul, and score provide concise single-question commands for shell scripts. Effect CLI v4 handles arguments and the TypeSafe JavaScript SDK performs each judgment. A TypeSafe API key for live requests. You can persist the variable in your shell profile or place it in a .env file in the directory where you run jev. Bun loads that file automatically.

Quoted from the project's README. Read the full README.

Tagscommunity github

Works forJev for Classification

Used inJev for Software & DevTools

Highlights

State accepts inline JSON, files, plain text, or stdin; Bun auto-loads .env for the API key.
Choice needs two or more labels; Noul prints 0-1 probability; Score prints zero-indexed weighted level.
Criteria and levels accept inline values or JSON files; --choices and --levels should be final flags.
Built on Effect CLI v4 with TypeSafe JS SDK 0.6.x and generated --help per command.

Watch out

Needs Bun and a TypeSafe key; dry runs only validate local inputs and cannot report auth or server errors. Copy reviewed against the repository README on 2026-10-04, not from running it.

Questions about this entry

Short answers drawn from the linked project or page.

More Jev resources like this

SwiftJev

Swift provider adapter that sends typed noul, choice, and score prompts to the hosted System One API through SwiftDecision DecisionBackend, returning validated probability distributions.