Jev CLI
開発者 jtsang4
状態と型付きの質問を Jev に送信する、設定可能な CLI。
実装の概要
設定、診断、構造化した JSON の評価結果を提供します。リポジトリには英語・中国語の利用説明と、TypeSafe プロバイダーの直接サポートが含まれます。
試せること
ターミナル、シェルスクリプト、CI から Jev の評価を実行したいときに使います。state と、boolean・choice・score の質問を JSON で渡すと、構造化された JSON が標準出力に返ります。入力はファイルや標準入力から渡せるので、git diff を保存済みの質問ファイルで点検することもできます。
必要な環境
npm install -g @jtsang/jev-cli(または bun install -g @jtsang/jev-cli)で導入し、Node 22 以上か Bun で動作します。jev-cli config set providers.jev.apiKey で自分の TypeSafe キーを保存してから jev-cli doctor を実行すると、小さな評価を 1 回送り、キーとモデルが使えるかを確かめます。--offline を付ければ通信せずに設定だけを確認できます。設定は ~/.jev-cli/config.yaml(権限 0600)に保存され、コマンドラインのフラグ、環境変数、設定ファイルの順に優先されます。
制限と根拠
Jev が返すのは文章ではなく判定です。この CLI は分類、振り分け、基準による採点、自動チェック向けで、文章の生成には使えません。各質問は同じ state に対して個別に評価されるため、結果の組み合わせは自分のコードで行います。README では boolean の確率は未較正とされています。jev-latest と jev-preview はリリースのたびに中身が変わるので、しきい値を決めたら jev-1.13.0 のようにバージョンを固定してください。Vercel AI Gateway 経由で使う場合は、別途ゲートウェイのキーが必要です。Jev Atlas は README を確認しましたが、CLI 自体は実行していません。
README の例
README の例:現在の git diff を state としてパイプで渡し、質問ファイルに沿って評価します。
git diff | jev-cli eval --state-file - --questions-file ./checks.json次に読む資料と確認先
テーマ
リクエストの例
プロジェクトを組み込む前に、小さなサンプルを編集して実際のリクエストをコピーできます。