エージェントプラグイン

現在の ChatCut Agent Plugin は、Claude Code、Codex、WorkBuddy から ChatCut のプロジェクトを作成・編集するためのプラグインです。ホスト型の接続を使い、認可はエージェントが開くブラウザー画面で行います。公開 npm パッケージ @chatcut/skill v0.2.1 の CLI は、下で説明する別の導入方式です。

現行プラグインの対応アプリ

この手順はデスクトップのエージェントアプリで使います。Claude や ChatGPT の Web サイト、ChatCut の Web エディターにインストール指示を貼り付ける手順ではありません。

現行プラグインのインストールと認可

1. ChatCut の Web アプリにサインインし、アバターメニューの Agent Plugin から、使うアプリの Copy を選びます。
2. 対応するデスクトップアプリで新しい会話またはタスクを開き、コピーした指示を貼り付けて送信します。WorkBuddy は専用ガイドに従ってください。
3. エージェントが開く ChatCut の認可ページでサインインし、アクセスを許可します。Cookie、アクセストークン、パスワードをエージェントの会話に貼り付けないでください。
4. インストール後は新しい会話またはタスクを開始し、ChatCut を使ってどのように編集したいかを伝えます。ツールはセッション開始時に読み込まれるため、インストール中の会話に後から追加されるわけではありません。

Claude Code の新しい会話に送る指示：

Codex デスクトップアプリの新しいタスクに送る指示：

WorkBuddy では上の2つの指示を流用せず、専用ガイドの手順を使います。接続エラーで認可ページが開かない場合と、開いた後に認可が中断された場合は段階を分けて扱ってください。現行プラグインの更新方法と接続の問題は、現在の英語版ガイドで確認できます。

別方式：公開 npm CLI v0.2.1

公開 npm パッケージ @chatcut/skill v0.2.1 は、chatcut CLI と Claude Code 向けのスキル登録を提供する別方式です。以下はこの公開 CLI バージョンの説明です。現行の Claude Code / Codex / WorkBuddy プラグインのインストールには、上の手順を使ってください。

インストール方法

npm install -g @chatcut/skillを実行してから（pnpm add -gやyarn global addでも同じように動作します）、Claude Codeを再起動します。グローバルインストールが必須です。スキルはPATH上のchatcutバイナリをそのまま呼び出すため、npx @chatcut/skill submitでは動作しません。インストール時のpostinstallステップがSKILL.mdを~/.claude/skills/chatcut/SKILL.mdにコピーし、Claude Codeがスキルを自動的に読み込みます。この登録はベストエフォートで、失敗してもnpmインストール自体は成功します。インストール後もClaude Codeがスキルを認識しない場合は、chatcut installを実行して手動で登録してください。

動作要件

chatcutCLIにはNode.js 18以降が必要です（package.jsonのengines.node >=18）。

CLIでできること

chatcutコマンドには9つのサブコマンドがあります。install（--linkオプション付き）、update、login、logout、pick、submit、status <jobId>、watch <jobId>、helpです。中心になるのはsubmitで、必須の--prompt <text>と、繰り返し指定できる1つ以上の--asset <source:type>（typeはaudio、gif、image、videoのいずれか）を受け取り、さらに任意で--name <string>、--resolution <480p|720p|1080p>、--format <audio|video>、--codec <h264|mp3|prores|vp8>、--max-turns <n>、--model <name>を指定できます。素材のパスが手元にない場合は、chatcut pickでネイティブのファイル選択ダイアログが開き、submit --assetにそのまま渡せるpath:type形式の行が出力されます。

chatcut submitが動画を作成する仕組み

submitにプロンプトとメディアを渡すと、パイプライン全体が自動で走ります。編集内容を普通の言葉で説明し、素材は公開URLかローカルの絶対パスで指定します。どちらもまったく同じように扱われます。CLIがローカルでトランスコードしてアップロードし、ChatCutのエージェントがサーバー側でタイムラインを組み立て、クラウドで動画がレンダリングされ、署名付きのダウンロードURLが返ります。--resolutionと--formatを指定しない場合、CLIは1080pの動画を既定とする書き出し指示をプロンプトの末尾に自動で追加します。ジョブの送信は有料の操作なので、エージェントが送信前に文言を変えた場合は、いったん処理を止めて実際の--promptテキストを提示し、承認を求めることが義務付けられています。

所要時間と進捗の確認方法

chatcut submitはジョブが完全に終わるまで戻りません。トランスコード、アップロード、エージェントの編集ループ、クラウドレンダリングのすべてが終わってから終了し、その間ずっと読みやすい進捗をstderrに出力し続けます。内部的には3秒ごとにジョブの状態をポーリングし、40分以内に終わらない場合はタイムアウトエラーで打ち切ります。

生成結果の保存先

chatcut submitは実行のたびに新しいChatCutプロジェクトを作成し（--nameで名前を指定するか、既定の名前をそのまま使います）、実行が終わった時点でそのプロジェクトのprojectId、ジョブのjobId、レンダリング済みファイルの署名付きoutputUrlを、標準出力に1行のJSONとして出力します。

chatcut loginの要否

必要ありません。保存済みのAPIキーが見つからない場合は、submitが自動でブラウザーを開いてログイン画面を表示し、完了後そのままジョブを続行します。そのため、初回のsubmitの前にchatcut loginを別途実行する必要はありません。このログインではChatCutのログインページを開いたブラウザーウィンドウが表示され、承認するとCLIが裏側でその結果を長期有効なAPIキーと交換します。フロー全体は未完了のまま5分経過するとタイムアウトします。

「Codexプラグイン」との違い

@chatcut/skill v0.2.1 が自動登録するスキルの保存先は ~/.claude/skills/chatcut です。この登録方式は、現行の Codex プラグインの導入とは異なります。Codex で現行プラグインを使う場合は、上の現行プラグインのインストールと認可に従ってください。

関連情報：ChatCutエディターの画面構成。

ChatCutエージェントプラグインのインストールとログイン

npm install -g @chatcut/skillでこのCLIをグローバルにインストールし（pnpm add -gやyarn global addでも同じように動作します）、Claude Codeを再起動します。Node.js 18以降が必要です。インストールするとSKILL.mdが~/.claude/skills/chatcut/に登録され、Claude Codeがスキルを自動的に読み込みます。（--ignore-scriptsを使った場合など）この登録が行われなかったときは、chatcut installを実行して手動で登録します。グローバルインストールが必須で、Claude Codeの中からnpx @chatcut/skillを使うことはできません。

ログインを別の手順として済ませておく必要はありません。最初のchatcut submitを実行するとブラウザーが開いてPKCEベースの認可交換が始まり、完了しないまま5分経過するとタイムアウトします。先にログインしておきたい場合は、chatcut loginを実行してください。

関連情報：ChatCutへのログイン方法。

ChatCutエージェントプラグインでできることと制限

@chatcut/skill v0.2.1 の chatcut CLI は、プロジェクトの作成、メディアのアップロード、自然言語によるAI編集ジョブの実行、署名付きダウンロードURLの返却までを1つのコマンドでまとめて行います。chatcut submitにはプロンプトと素材（URLまたはローカルファイルパス）を渡します。コーデックがブラウザー互換でない場合、フレームレートが30fpsを超える場合、ビットレートが8Mbpsを超える場合にだけローカルでトランスコードし、長辺を1920pxに収めます。それ以外はファイルを手を加えずにアップロードします。その後はChatCutのサーバー側エージェントによる編集とクラウドレンダリングが終わるまで処理をブロックし、進捗をstderrに、最終的なjobId／projectId／outputUrlのJSON行をstdoutに出力します。

制限：submitは3秒ごとにポーリングし、40分でタイムアウトします。chatcut status <jobId>はジョブの状態を1回だけ確認し、chatcut watch <jobId>は最大20分間ポーリングします。CLIは24時間ごとに新しいバージョンの有無を確認し（結果はキャッシュされます）、知らせるだけでコマンドをブロックすることはありません。

関連情報：ChatCutエージェントプラグインのインストールとログイン。