コマンドラインとオープン機能

/cli を開きます——左側ナビのコマンドラインもそこへ行き、新しいページで開きます——以下二つのルートから選びます：

• AI Agent でインストール（デフォルトのタブ）—— カードに書かれたプロンプトを AI アシスタント（Claude Code、Cursor、Codex など）にコピーすれば、skill のインストールをやってくれます。
• 手動インストール——二段階：まずカードの npm コマンドを実行し、次の節に従ってログインします。

npm パッケージとして配布されているので、最初のコマンドはすべてのプラットフォームで同じです。マシンに Node.js 20 以降が入っていれば動きます。

npm i -g @dotv/cli

手動のルートでは、コマンド本体だけがインストールされます。もう一度コマンドを実行すると、各コマンドの説明が書かれたマニュアルもインストールされます——それは ~/.claude/skills に置かれ、AI アシスタントがこのコマンド群を覚えるのに使います（カレントプロジェクトにだけ入れたい場合は --dir .claude/skills を追加してください）。

dotv skill install

同じコマンドでマニュアルの更新も行えます：すでに最新版なら何も書き込みません。CLI 本体をアップグレードしてもマニュアルは更新されないため、手元のマニュアルが古くなると、dotv は次のコマンドの出力で一行警告を出します。インストール後は、AI アシスタントを再起動して、新しい skill を読み込ませることを忘れないでください。

ターミナルにブラウザはなく、そこにパスワードを打ち込むべきでもないので、デバイスコードのフローを使います——あなたが打つコマンドは以下の一行だけです。

dotv login

ショートコード付きの URL が表示され、ブラウザを自動で開こうとします。画面に表示されたコードと、ターミナルに表示されているコードが同じ文字列か確認し、承認してください。その URL はブラウザのある任意のマシンで開けます——これがこのフローの存在理由です：サーバー上で動くコマンドラインにはブラウザがないからです。

承認後、あとは何もする必要がありません。セッショントークンを長期キーに自動で交換し、~/.dotv/ に保存します（パーミッション 0600）。それ以降のすべてのコマンドはそのキーを使います。（Agent や CI がデバイスコードのフローを手動で回したい場合、四つのステップと四つのポーリング結果は auth.md に書かれています。）

dotv login が発行するキーは、あなたのマシンの ~/.dotv/ にのみ存在します。私たちが保存しているのはそのハッシュです。

• ウェブでサインアウトしても失効しません。自己完結で期限切れにもなりません。
• dotv api-key list はあなたが発行したものを列挙します（プレフィックスのみで、元の文字列は決して表示されません）。dotv api-key delete --id <id> で一本を失効します——失効は即座に効果を発揮し、猶予期間も取り消しもありません。
• dotv whoami は、このマシンが今どのサイトに接続していて、どのキーを使っているかを表示し、その場でサーバーに問い合わせてキーがまだ有効か確認します。
• dotv logout は、このマシンの ~/.dotv/ にあるコピーだけを削除します。キー自体は有効なままです——本当に無効にするには、上記の api-key delete を使ってください。
• 別のマシンでは、もう一度 dotv login を実行します。CI にはブラウザがないためデバイスコードのフローは使えず、DOTV_API_KEY 環境変数にあらかじめ作ったキーを渡してください。

キーは常にあなただけのものです。チームの誰かに見られることはありません。ウェブ上からキーを作る方法はありません——これはコマンドライン専用の機能です。

skill としてインストールしてアシスタントにマニュアルどおりコマンドを打たせるほかに、dotv 自体を MCP サーバーとして動かせます。Claude Code、Codex、Claude Desktop、Cursor など MCP 対応アプリからターミナルを介さずツールとして直接使えます。

dotv mcp --print-config
claude mcp add "dotv" -- npx -y @dotv/cli mcp

1 行目は各アプリの設定ファイルに貼るスニペットを表示し、2 行目は Claude Code 向けのワンライナーです。接続するとアシスタントは 3 つのツール —— dotv（コマンドラインとまったく同じ書き方で 1 コマンド実行）、dotv_help（リファレンス参照）、dotv_wait（ノードの一括生成が終わるまで待つ）—— を得て、マニュアル自体もリソースとして公開されるので skill を別途入れる必要はありません。使う鍵は dotv login が保存したもので、ほかに設定はいりません。

デスクトップアプリを開いていれば、アシスタントが作ったノードや切り替えたプロジェクトは目の前のキャンバスに現れ、自分でクリックしたのと変わりません。 クレジットを消費する操作はエージェント設定で決めたルールに従って確認します。あるクライアントが初めて接続するとデスクトップアプリが許可を求め、答えは記憶されます。エージェント設定には接続したことのあるクライアントがすべて並び、いつでも個別にオフにできます。

アシスタントの操作もこのキャンバスの Agent タイムラインに残ります。何をしたか、どのノードを変えたか、生成が終わったかをキャンバスで確認でき、ログイン中の他の端末にも通知が届きます。デスクトップアプリがないときも結果はクラウドのプロジェクトに保存されるため、キャンバスに戻れば同じように見えます。

アシスタント用の鍵は別に発行し、上限を付けるのがおすすめです。上限に達すると消費は止まります：

dotv api-key post --name "claude-code" --budget-credits 500

dotv <グループ> <アクション>

グループはコマンドが扱う対象、アクションはその内容です。たとえば：dotv canvas list、dotv generate post-image、dotv model。オプション名はフィールド名をキャメルケースからハイフン区切りに変えたものです：canvasId → --canvas-id。

完全なリファレンスは /cli ページの下半分にあります：各コマンドが受け取るオプション、その型、必須かどうか、返す値などが書かれています（コマンドリファレンス原文 も直接開けます）。この節ではそれを繰り返しません。コマンドリファレンスは CLI と一緒に更新されるため、そちらを正としてください。

バッチスクリプトを書く前に確認しておきたいコマンドが2つ：

• dotv model（または dotv model list）—— 現在使用できるモデルの一覧：キー、正式名、どのノードタイプに属するか。--node-type video で1種類に絞り、--keyword kling で名前で検索できます。
• dotv model --key <key> —— そのモデルが受け取るパラメータ：各パラメータの型、取りうる値 / 範囲、デフォルト、必須かどうか。sync の data や post-generate の --params（その場限りの上書き）にそのまま書き写せます。

一覧は Web 版の入力欄にあるモデルドロップダウンと同じものです（モデルと料金は 14.8）：画面で選べないモデルは、ここにも出てきません。

コマンドラインから見える範囲も、同じようにスコープ分けされています（14.2 参照）：

• スペース引数なし = 個人スペース；
• --x-team-id <チームID> あり = そのチームのスペース（チーム ID はチーム管理のヘッダー右端の**⋯**の中にあり、クリックでコピーできます）。

コマンドラインからの生成も同じウォレットから消費され、価格はウェブとまったく同じです（14.8 参照）。以下の三つのコマンドで確認できます：

• dotv credits wallet —— 残高と履歴。残高は三つの枠の合計で、レスポンスには汎用クレジットの枠だけの数値も含まれます（各枠の違いは 14.3 を参照）；
• dotv credits estimate —— 実行前に価格を問い合わせ、一度にまとめて見積もれます（数十ショットの分鏡表全体を一度に見積もるのが通常の使い方です）；
• dotv membership —— このスペースの現在のプラン、期限、月間クレジット、同時実行できるタスク数。

すべてのコマンドは --json に対応しているので、出力はそのまま次のプログラムにパイプできます。