CLI コマンドリファレンス
リリース済みの @evolinkai/cli 0.14.1 が対象です。インストールされているバージョンについては、evolink —help または evolink COMMAND —help —json を使ってください。業務コマンドは —json に対応しています。MODEL_ID、QUOTE_ID、TASK_ID、UPLOAD_ID は、実際に返された値に置き換えてください。認証、診断、スキル
インストールを参照してください。
agent の値：all/codex/claude-code/cursor/gemini/opencode/copilot/openclaw/hermes。デフォルトは all です。アシスタントがスキルを検出できることは、別途検証する必要があります。
setup、doctor、auth login の出力には update（status、update_available、latest_version、command）が含まれます。そのほかのコマンドは、新しいリリースがある場合に、多くても1日1回、stderr に通知を出力します。確認をオフにするには EVOLINK_CLI_UPDATE_CHECK=0 を設定します。新しいバージョンがあることを知る方法を参照してください。
モデル、入力、ドキュメント
docs search は、同梱の公式モデルリファレンスの索引を使います。ウェブサイトをその場でクロールするわけではありません。推奨は、ドキュメントに記載された入力、キーワード、プラットフォームの編集上の優先設定に基づくもので、人気ランキングではありません。単価はタスクの見積書ではありません。
見積書と生成
モデルの実際のパラメータを使って input.json を作成し、無料の見積書を取得します：
見積書の作成に成功すると quote_id が返されます。見積書は、見積もった時点から24時間有効で（
expires_at）、ログイン、バックエンド、モデル、正確な入力に紐付けられます。生成では、送信前に価格ルールをもう一度読み込みます。同じ入力で、承認済みの価格以下であれば、その後にルールが変更されていても送信されます。価格が上がっていれば price_changed、入力が変わっていれば quote_input_changed、見積書の有効期限が切れていれば quote_expired で失敗します。これらの場合は何も送信されず、新しい見積書と承認が必要です。失敗した見積もりや、上限によって拒否された見積もりは、利用できる見積書にはなりません。課金使用量が不足している見積もりは、不足している値と、それを指定するためのオプションをそれぞれ示して失敗し、見積書は保存されません。仕様、範囲、警告を示し、明確な承認を待ってから、対応するコマンドを選びます：
quote_superseded で失敗し、現在の見積書またはそのタスクが示されます。送信がすでに始まっている見積書は更新できません（submission_already_started）。その場合は、代わりにそのタスクを復旧してください。別の更新が同じ見積書を置き換えている最中に実行された更新は、quote_refresh_conflict を返します。
--inputs-file から作成した見積書は、バッチ全体を対象とします。generate --quote QUOTE_ID --confirm は、すべての入力をまとめて送信し（同時に最大10件）、完了を待たずに、各入力のタスク ID またはエラーを返します。--wait は単一のタスク用です。結果は tasks batch --ids で取得します。
ユーザーが、見積もりや確認は不要だと明確に述べた場合に限ります：
--skip-estimate は、見積書なしで送信します。--inputs-file と併用した場合も同じです。価格はチェックされず、タスクは実際の使用量に基づいて課金され、結果にもその旨が示されます（estimate_skipped）。無効な入力は、引き続き拒否されます。また、明示した --max-cost-usd は引き続き適用されます。これを超えるリクエストや、これと照らして価格をチェックできないリクエストは、送信されません。--skip-estimate は、--quote や --confirm とは併用できません。このコマンドは、独自のリクエスト ID を持つ記録を保存し、tasks resume 用の quote_id を返します。
—wait は、既存のタスクの完了を待ちます。タイムアウトは1–86400秒で、デフォルトは1800秒です。タイムアウトや Ctrl-C では、サーバー側のタスクはキャンセルされません。タイムアウトには、すべての読み取り、再試行、待ち時間が含まれます。上限に達すると、wait_timeout が、最後に検証できた状態とその read_at を報告します。最新の状態を読み取れなかった場合は、status_check: unverified を報告します。完全な見積もりでは、送信時のチェックに、その見積もりで示された最大額がデフォルトで使われます。予算に関する制限を参照してください。
タスク、バッチ、復旧
時刻によるフィルタリングは、選択したページにだけ影響します。履歴はアカウント全体が対象で、このチャットだけのものではありません。ページが空でも、送信がなかったことの証明にはなりません。total は、ローカルでの時刻フィルタリングより前の値です。バッチの ID は、カンマ区切りで1–50個の値を指定します。
タスク ID がある場合は、get/wait を使います。送信のレスポンスを受け取れなかった場合は、元の見積書を、そのリクエスト ID とログインのまま再開します。バッチの場合、
tasks resume --quote QUOTE_ID は送信されなかった入力を完了させます。受け付け済みの入力については元のタスクが返され、新たな課金は発生しません。tasks resume がリクエスト ID で再送するのは、最初の送信から23時間以内に限られます（EvoLink はこのリクエスト ID を24時間保持します）。それを過ぎると、recovery_window_passed で拒否されます。見積書のルールにも従うため、見積書の有効期限が切れている場合（quote_expired）や価格が上がっている場合（price_changed）は、何も送信されません。いずれの場合も、tasks batch または tasks list で通ったものを確認し、残りだけを新しい生成またはバッチとして見積もってください。記録が失われた場合、期限が切れた場合、アカウントが変わった場合は、次の有料の操作を行う前に、履歴またはコンソールを確認してください。CLI にはキャンセル用のコマンドがありません。
残高とタスクの使用量
アップロードとオリジナルファイルのダウンロード
JSON、終了コード、設定
—json は、schema_version:1 と ok を含む JSON を、stdout に1行で出力します。進行状況は stderr に出力されます。エラーの場合は ok:false/error となり、終了コードはゼロ以外になります。Ctrl-C では、通常は終了コード 130 で終了します。タスクの status:failed は、照会の呼び出し自体の失敗とは別のものです。まずコマンドの ok を確認し、次にタスクの状態を確認してください。 ローカルの記録は ~/.evolink-media に残り、認証情報は OS の安全なストレージに保存されます。ログインを移行するためにこのディレクトリをコピーしたり、結果が不確かな送信を解決するために見積書や復旧の記録を削除したりしないでください。 上級者向けの —server は、OAuth リソースとアイデンティティの紐付け先を選択します。デフォルトは https://mcp.evolink.ai/mcp で、REST の実行経路は変わりません。—api-url/—files-url は、本番環境のデフォルトのままにしてください。任意の外部 URL は拒否されます。—token-stdin は、単一のコマンドに限って使う OAuth アクセストークンを渡すためのもので、プラットフォームの API Key ではなく、setup 用でもありません。トークンをコマンドの引数やログに含めないでください。 汎用の run、テキストチャット、キャンセル、チャージ、キー管理、カスタムのエイリアスファイル用のコマンドは提供されていません。対応するコンソールまたは API を使ってください。CLI の実行経路と API
CLI 0.8.0 以降、メディアリクエストはターミナルまたはエージェント → EvoLink CLI → プラットフォーム REST API の経路を通ります。入力チェック、モデルのリファレンス、見積もり、結果の整形はローカルで実行されます。業務の実行では、リモート MCP の tools/call は呼び出されません。コマンドとバックエンドの操作
CLI の quote_id、—confirm、復旧用ファイルは、クライアント側のワークフローを実装するもので、バックエンドの新しいフィールドではありません。公開済みの CLI 0.14.1 は、公開の価格ルール（参考価格で、アカウントの割引は含みません）から見積もります。—max-cost-usd は、最終的な精算額の上限ではありません。
リクエスト、復旧、自動化
送信の前に、見積書とリクエスト ID を永続的に保存してください。REST では、既存の Idempotency-Key / X-Evo-Run-Id という識別子を使います。レスポンスを受け取れなかった場合は、元の見積書を使って復旧してください。再送信するために、アカウント、入力、識別子を変えてはいけません。クライアント側の記録だけでは、本番環境のすべてのノードでバックエンドの冪等性が一様に保証されていることの証明にはなりません。 スクリプトでは、まず ok を確認し、次にタスクの status、その次に結果と料金のフィールドを確認してください。ターミナルの最後の行に頼るのではなく、quote_id、task_id、ダウンロードのマニフェストを保存してください。照会のエラー、タスクの失敗、ダウンロードの失敗は、それぞれ異なる対処が必要です。有料の送信を無条件に再試行しないでください。 CLI とネイティブ MCP のセッションは別々に管理されますが、現在、アカウントの OAuth はEvoLink MCP (OAuth) の権限、上限、一時停止状態を共有します。ネイティブ接続については、別の MCP ドキュメントを使ってください。