Skip to content

jev-cli

Python CLI that analyses JSON, NDJSON and JSONC logs and artifacts with Jev question packs, anchoring each answer to source lines.

CLIbeta

Overview

jev-cli by joshlong145, installed as jcli, analyses JSON, NDJSON and JSONC system artifacts such as logs with Jev and returns typed, calibrated answers instead of prose. Questions come in packs, such as a logs triage pack asking whether lines are an incident, how severe on an ordered scale, and which category (application or dependency, for example), applied over sliding windows of records.

Every answer is anchored to the source lines it came from and carries a certainty number, so you can gate on it; a mark-uncertain option flags low-certainty rows, and for Noul answers it reports a derived certainty rather than an API confidence. Output can be a table or JSON, with call and token counts. An install script uses uv, supports editable, dry-run and uninstall modes, and verifies after installing that the built-in packs and transforms shipped.

What the decision model decides

TypeQuestionAnswers
Yes / noDo these log lines indicate an incident?yes · no
ScoreHow severe is it?Informational · ... · Outage
ChoiceWhich category does it fall into?application · dependency · ...

How it works

  1. Choose a question pack and window size
  2. jcli reads JSON/NDJSON/JSONC records
  3. Jev answers pack questions per window
  4. Output answers anchored to line ranges with certainty

Strengths

  • Answers traceable to exact lines
  • Reusable question packs
  • Install-time self-checks

Caveats

  • Derived certainty for Noul is not an API confidence
  • No licence stated in the excerpt

Getting started

`./scripts/install.sh`, `export TYPESAFE_API_KEY=...`, then `jcli analyze app.ndjson --pack logs.triage --window 2`.

At a glance

Type
CLI
Status
beta
Language
Python
Runtime
CLI
Has code
yes

Use cases and integrations

How curated lists describe it

Frequently asked questions

What does jcli analyse?

JSON, NDJSON and JSONC artifacts such as application logs.

How are answers traced?

Each is anchored to the line range it came from.

What is a pack?

A reusable set of questions, such as logs.triage.

Related projects

  • Go utilities for TypeSafe: a grep-like qgrep CLI, a kubectl plugin for asking questions about pod logs, and an SDK.

    ServicebetaGo
  • Jev★ 8

    PowerShell module that builds Jev Noul, Choice and Score questions and returns answers as pipeline-friendly properties.

    LibrarybetaPowerShell
  • Self-hosted Stacks blockchain data service whose Slack gate and fault-triage paths reportedly run on Jev decisions.

    ServiceproductionTypeScript
  • Home Assistant integration that runs weekly checks with Jev judgments and turns confident findings into Repairs cards for you to confirm.

    ProjectbetaPython
  • Scores OpenTelemetry logs with Jev for diagnostic value, priority and routing before any expensive LLM analysis.

    ProjectbetaTypeScript
  • Splunk search command that asks Jev typed questions about events and adds probabilities, choices and scores as fields.

    AppbetaPython