メインコンテンツまでスキップ

Yabanin CLI (yb)

yb は1つのバイナリに2つの役割があります。ネットワークと一切通信しないオフラインの支出監査(yb audit)と、サービスの健全性を確認し、yabanin-admin の読み取り専用サービス API(/internal/*)から組織データ(API キー、コストと削減の利用分析)を読む、機能を絞ったオペレータ向けクライアントです。

# install (from the repository root)
go build -o bin/yb ./cmd/yb
bin/yb --help

グローバルフラグ​

フラグデフォルト説明
--admin-urlhttp://localhost:8086サービスコマンドが通信する yabanin-admin のベース URL
--api-key—管理用のサービスキー。X-Admin-Key ヘッダとして送信します(下記参照)
--org—組織 ID。keys list と spend に必須です
--base-url自動検出ゲートウェイのベース URL(ゲートウェイ向けコマンドで使用)

サービスキーは、yabanin-admin サーバに設定された YABANIN_ADMIN_API_KEY と一致する必要があります。一致しない場合、/internal サービス API はまったくマウントされません。本番ランブック — 内部サービス API を参照してください。

実際のキーをシェル履歴や、コミットされるスクリプトに書かないでください。--api-key か、シェルがローカルで展開する環境変数で渡します。

コマンド​

yb version​

CLI のバージョンを表示します。

yb version
# yb 0.1.0

yb doctor​

ゲートウェイ(/healthz)と管理パネル(/health)の確認は、オペレータが --base-url/--admin-url または YABANIN_GATEWAY_URL/YABANIN_ADMIN_URL で対象を設定した場合にのみ行います。フラグは対応する環境変数より優先されます。既存のベースパス接頭辞は保持されます。導入モードとリージョンが対象を自動で選ぶことはありません。

yb doctor --base-url http://localhost:8085 --admin-url http://localhost:8086
yb doctor --offline

--offline は、設定済みの対象を含め、すべてのリクエストをスキップします。対象がない場合も確認はスキップされます。どちらの場合も健全性は不明と報告し、非ゼロで終了します。サービスの健全性は確認されません。選択した対象が不健全、または到達不能な場合も非ゼロで終了します。選択したすべての対象の確認が成功すると、ゼロで終了します。

各リクエストのタイムアウトは5秒で、コマンドのキャンセルを尊重し、リダイレクトを拒否します。対象は、資格情報、クエリパラメータ、フラグメントを含まない HTTP(S) URL である必要があります。無効な対象はリクエストを出さずに拒否されます。対象 URL とトランスポートの詳細は診断から省かれます。設定した URL を直すか、サービスの接続を復旧してから、コマンドを再実行してください。これらの診断は選択したヘルスエンドポイントを対象とし、バックエンドやブラウザの外向き通信を監査するものではありません。

yb keys list​

1つの組織の API キー(名前、有効状態、作成日)を一覧表示します。キー一覧には平文のキー素材は設計上含まれません。管理ストアが保持するのはハッシュのみです。

yb keys list --org <org-id> --api-key <service-key>
# NAME STATUS CREATED
# deploy active 2026-08-01
# ci inactive 2026-07-01

ページネーション: yb keys list --org <org-id> --api-key <service-key> --page 2 --page-size 10。--page/--page-size を付けない場合はサーバのデフォルト(1ページ目、サイズ 50)が適用されます。組織のキーが1ページに収まらない場合は、「Showing N of M keys」というヒントが表示されます。

yb spend​

指定した遡及期間について、組織の削減の利用分析を表示します。リクエスト総数、実際のコストと反事実コスト、合算の削減額、モデルごとの内訳です。

yb spend --org <org-id> --api-key <service-key>
yb spend --org <org-id> --api-key <service-key> --days 30 # -d 30

yb audit​

オフラインの支出分析です。ローカルの LLM リクエストログ(JSONL、CSV、またはこのゲートウェイの形式)を指定します。実際の支出と、シミュレーションしたキャッシュおよび経路の削減額を報告します。ゲートウェイ、管理 URL、API キー、組織は不要で、--cache-mode exact(デフォルト)ではネットワーク呼び出しを行いません。

yb audit path/to/traffic.jsonl
yb audit path/to/traffic.jsonl --format html --output report.html --no-prompts
フラグデフォルト意味
--format, -fmdmd、json、または html
--cache-modeexactexact、semantic、または off
--output, -o(標準出力)レポートをこのファイルに書き出します
--no-promptsfalseハッシュ化の後、生のプロンプト本文を捨てます

--cache-mode semantic だけが、起動中の embedder を必要とします。完全にオフラインで実行する場合は exact を使います。意味の詳細、サンプルデータ、レポートが主張しないことについては、オフラインの支出監査 を参照してください。

エラーの意味​

CLI エラー意味
--api-key required--api-key フラグが指定されていません
org required--org フラグが指定されていません
admin service rejected the key: check --api-key and that yabanin-admin has YABANIN_ADMIN_API_KEY setHTTP 401 — キーが誤っているか、管理サーバに YABANIN_ADMIN_API_KEY が設定されていません
admin service: org_id query parameter is requiredHTTP 400 — サーバ側の組織検証
admin service unreachable at <url>接続拒否 / タイムアウト(クライアントのタイムアウトは 10 秒)

セキュリティ上の注意​

  • /internal サービス API は読み取り専用かつ組織スコープです。どちらのエンドポイントも org_id を必須とし、変更操作は公開しません。
  • サーバ上のキー比較は定数時間です。キーの値は CLI からもサーバからもログに記録されません。
  • サービス API への通信はすべて、セッション Cookie では認証されません。ローカルまたはループバックの自動化向けです。信頼できるネットワークにのみ公開してください。