krillinai-cli

KrillinAI CLI

KrillinAI のコマンドライン操作では、最上位のルーティングスキルとしてこれを使用してください。

バイナリのビルドと場所の確認

リポジトリのスクリプトを使って、KrillinAI の両方のバイナリをビルドします。

pnpm krillinai:build

現在のマシン向けの CLI を、プラットフォームやアーキテクチャを前提とせずに見つけます。

TARGET="$(node -p "process.platform + '-' + process.arch")"
SUFFIX="$(node -p "process.platform === 'win32' ? '.exe' : ''")"
KRILLINAI_CLI="$PWD/.runtime/build/krillinai/$TARGET/bin/krillinai-cli$SUFFIX"
test -f "$KRILLINAI_CLI"

CLI は、プロセスの作業ディレクトリを基準に config/config.toml を読み込みます。ソースチェックアウトから実際に実行する場合は、プロセスの作業ディレクトリとして runtime/krillinai を使用し、既存のファイルを上書きせずに、config/config-example.toml から無視対象の config/config.toml を作成してください。リリースアーカイブは、展開したパッケージのルートディレクトリから実行してください。

ビルドの構成、設定、JSON、マニフェスト、出力、エラーの詳細については、以下を参照してください。

skills/krillinai-cli/references/cli-contract.md

コマンドを選択する

ユーザーの目的	コマンド／スキル
ソース、ターゲット、バイリンガル、短尺縦型の字幕を生成する	subtitle。krillinai-subtitle を使用
字幕からターゲット言語の吹き替えを生成する	tts。krillinai-tts を使用
横型動画を作成する	render-horizontal。krillinai-render-horizontal を使用
縦型／短尺動画を作成する	render-vertical。krillinai-render-vertical を使用
完全な画像プロンプトからカバーを生成する	cover。krillinai-cover を使用
プレーンテキストから音声を生成する	speech
Aliyun、OpenAI、または MiniMax のプロバイダー音声コードを一覧表示する	voices
要求された複数段階の出力プランを検証する	pipeline --dry-run。krillinai-pipeline を使用

pipeline がプランを検証するのはドライランモードのみです。ドライラン以外で実行すると unsupported_command が返されます。status は予約済みで、サポートされていません。

エージェントの運用ルール

• 専用の --workdir を使用し、リポジトリのルートに出力を散在させないでください。
• 外部呼び出しの前に、コマンド形式の検証に --dry-run を使用してください。
• 標準出力は JSON Lines として解析してください。ターミナル応答は ok を含むオブジェクトです。OpenCreator モードでは、その前に進捗フレームが出力されることがあります。
• 実際のステージ実行後は、krillinai_manifest.json と実際の出力ファイルを信頼できる情報源として扱ってください。
• 後続のステージでは、ファイル名を推測せず、マニフェストの出力を再利用してください。
• コマンドが失敗した場合は、error.kind に基づいて usage、retryable、dependency、internal のいずれかに分類してください。
• マニフェストに有効な上流出力がすでにある場合、高コストのステージを再実行しないでください。
• cover が参照画像を使用したと主張しないでください。現在の CLI が受け付けるのは、完全なテキストプロンプトとサイズのみです。
• Edge TTS の音声カタログを要求しないでください。現在、voices がサポートしているのは aliyun、openai、minimax です。

最小限のワークフロー

REPO_ROOT="$PWD"
WORKDIR="$REPO_ROOT/tasks/demo"
mkdir -p "$WORKDIR"

(cd "$REPO_ROOT/runtime/krillinai" && "$KRILLINAI_CLI" subtitle \
  "https://www.youtube.com/watch?v=VIDEO_ID" \
  --origin-lang en \
  --target-lang zh_cn \
  --workdir "$WORKDIR" \
  --caption-source any \
  --prepare-video)

(cd "$REPO_ROOT/runtime/krillinai" && "$KRILLINAI_CLI" render-vertical \
  --workdir "$WORKDIR")