Markdown版

AI-translated from English; not yet reviewed by a fluent editor.

# Rive CLIとコーディングエージェントの実践ガイド

> Rive CLIとRive Markup Language（RML）をコーディングエージェントと使い、インタラクティブなグラフィックを作成、確認、テストする方法を解説する。アカウント、署名、書き出しの制限も扱う。

By BIG CHANGE Editorial

Published: 2026-09-27T00:12:27.556Z
Updated: 2026-09-27T00:17:31.324Z
Canonical: https://bigchange.ai/blog/rive-cli-rml-coding-agents-guide

![A designer holds a controller while viewing an orange jointed animation shape on a wall-mounted display, with a smaller screen of indented lines nearby.](https://bigchange.ai/api/media/file/rive-cli-animation-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Riveの新しいCLIを使うと、コーディングエージェントはプロジェクトファイルを通じてインタラクティブなグラフィックを扱える。エージェントはRive Markup Language（RML）、Luauスクリプト、シェーダーを書き、CLIにコンパイル、検査、テスト、描画を依頼できる。人間はローカルプレビューを見ながらデザインを修正できる。RiveのスタッフはこのCLIを**9月11日にテクニカルプレビューとして公開**した。[Riveのダウンロードページ](https://rive.app/downloads)を9月27日に確認したところ、**Early Access**の項目に掲載されていた。

このチェックリストは[Riveのドキュメント](https://rive.app/docs/cli/overview)に沿っている。BIG CHANGEが確認したのはドキュメントのみで、CLIのインストール、ファイル作成、エージェントが生成したグラフィックのテストは行っていない。Riveの[動画チュートリアル](https://youtu.be/Y3E33otHeLE)では、人間とエージェントが協働する想定の手順を紹介している。

## 大きな変化

- **何が変わったか：**Riveのシーンに、コーディングエージェントが使えるテキストベースの制作経路が加わった。エージェントはプロジェクトフォルダー内のRMLを編集し、CLIは`.riv`をランタイム向けに出力し、`.rev`をEditorでさらに作業するためのファイルとして出力できる。
- **なぜ重要か：**デザイナー、フロントエンド開発者、ゲーム開発者は、ほかのプロジェクトファイルと並べてソースの変更を確認し、反復作業中にCLIのチェックを利用できる。それでも、製品に組み込む前に、描画されたデザインと操作性を人間が評価する必要がある。
- **今後の注目点：**ローカルの試作をWebに移すかは別の判断だ。スクリプトを含むファイルには署名済みの`--publish`ビルドが必要だ。クリーンな`.riv`ビルドにもアカウントファイルとの紐付けとCadet以上のワークスペースが必要になる。デプロイ前に条件を確認し、完成したグラフィックも点検すること。

## ドキュメントに沿った作業チェックリスト

1. **アクセス権を確認してインストールする。**Riveがサポート対象として挙げるのはApple Silicon搭載Mac、Linux x86\_64、Windowsだ。[Getting Startedガイド](https://rive.app/docs/cli/getting-started)にはWindows用とmacOS・Linux用の個別インストール手順がある。ページ内の最新のWindows手順を使う。インストール後に`rive doctor`を実行する。コマンドリファレンスには`rive --version`も記載されている。プレビュー版なので、実際にインストールしたバージョンを記録しておこう。Riveは9月11日の発表で、プレビュー期間中のCLIは制限なく無料だと述べた。*プレビュー期間中*という当時の説明はCLIの恒久的な価格を示すものではない。[現在のプラン一覧](https://rive.app/pricing)はRiveアカウントと組み込みEditor Agentを対象としている。公開前に最新の利用条件を確認する。
2. **テキスト形式のプロジェクトを作り、プレビューを開く。** `rive create myproject`でプロジェクトを作成し、`scene.rml`、`rive.yaml`、エージェント向けの指示を`AGENTS.md`と`CLAUDE.md`、`.gitignore`を用意する。次に`rive myproject`を1つのターミナルで実行する。Riveによると、CLIはフォルダーを監視し、保存時に再ビルドして出力先は`myproject/build/myproject.riv`である。ひな型のシーンにはアートボード、タイムライン、ステートマシンが含まれるが、描画内容はまだない。最初のプレビューは暗い四角形になる。
3. **コーディングエージェントにプロジェクトフォルダーと具体的なデザイン課題を渡す。**Riveの[AI Agentsガイド](https://rive.app/docs/cli/agents)はClaude Code、Cursorなど、ファイルを読み書きしてシェルコマンドを実行できるエージェントを挙げる。生成される指示ファイルには、対応オブジェクトやプロパティを調べるための`rive docs`と`rive schema`を使う方法が記される。RMLはXML形式で、要素がRiveの型、属性がプロパティを表し、入れ子構造でオブジェクト同士をつなぐ。エージェントは`.luau`スクリプトや`.wgsl`シェーダー、プロジェクトのアセットも編集できる。プレビューを見ながらレイアウトや挙動を調整できるよう、段階を分けて作業させよう。
4. **ビルドとその内容を確認する。**エージェントに`rive myproject --verify`を実行させる。コンパイルは行うが、`.riv`を書き出さず、`rive inspect myproject --summary`を実行すると問題点やオブジェクト数が報告される。解決後のシーン全体については`rive inspect myproject --json`が案内されている。プレビューを開かずに配布可能なローカルファイルを作る場合は`rive myproject --once`を使って未署名の`.riv`を書き出す。これらのチェックでコンパイルエラーや、シーン内のオブジェクトの不足・想定外を見つけられる。[RiveのRMLガイド](https://rive.app/docs/runtimes/advanced-topic/rml)は、ビルドが成功してもグラフィックが意図どおりに見えたり動いたりするとは限らないと注意している。
5. **重要な状態をキャプチャする。** `rive myproject --screenshot=out.png`はウィンドウを開かずにPNGを描画する。Riveの[サンプル](https://rive.app/docs/cli/examples)では、`--advance=1s`でアニメーション開始後のフレームを指定する。`--viewport=390x844`で画面サイズを指定し、バインドデータには`--data=battery/level=100`を指定する。模擬クリックには`--pointer=click@120,60 --advance=20`を使う。値や座標は自分のシーンに合わせて選ぶ。状態やビューポート寸法を変えて画像を比較し、自分でも確認しよう。アニメーション進行を指定しない場合、`--advance`は作成時の静止ポーズを表示するもので、必ずしもアニメーションの開始フレームではない。
6. **プロジェクトにある場合はスクリプトテストを実行する。** `rive myproject --test`はプロジェクト内のLuauの`Tests`テストスクリプトを実行する。Riveは自動チェック用に`--verify --format=json`と`--test --format=json`を案内している。ビルドやテストに失敗すると終了コードは0以外になる。エージェントは結果を使ってソースを修正できる。テストは記述されたアサーションだけを対象とするため、テストされない操作も確認しよう。
7. **ローカルの試作ができたら、アカウントを使う手順を選ぶ。**ランタイム用の`.riv`は実行時のアセットで、`.rev`はRive Editorで編集するファイルだ。Riveによると、ローカルでの作成、プレビュー、検証、テスト、スクリーンショット撮影はサインアウト状態でもオフラインでもできる。`rive login`を実行する必要があるのは：`--publish`、`--rev`、`rive push`、`rive pull`とリモートアカウントファイルのインポート。Editorから書き出したバックアップで始める場合は`rive create myproject --from-rev=myfile.rev`を使えばログインせずに取り込める。アカウントファイルから始める場合は`rive create myproject --from-remote-file`をログイン後に実行する。後者ではプロジェクトがそのファイルに紐付く：`rive push myproject`はリビジョンをアップロードし、`rive pull myproject`を実行するとEditor側の変更を取り込み、確認後に**ローカルのシーン、スクリプト、アセットを上書きする。**pullの前にローカルの変更を確認すること。
8. **公開前に署名と書き出し制限を確認する。** `rive myproject --publish`は署名済みの`.riv`を書き出し、ログインを必要とする。Riveによると、Webランタイムと同社CDNは未署名のスクリプトを拒否するため、Web用スクリプトを含むファイルにはこの手順が必要だ。`--publish`では透かしが入る場合がある。Riveの[コマンドリファレンス](https://rive.app/docs/cli/reference/commands)によると、透かしのない`.riv`を作るには、`rive push`でプロジェクトをアカウントファイルに紐付け、そのファイルをCadet以上のワークスペースに置く必要がある。シーンにスクリプトがなくても透かしの条件は適用される。`--rev=<path>`もログインが必要で、`--once`または`--publish`を併用できる。ただし、これはEditor用ファイルの書き出しであり、ランタイム用ファイルの代わりにはならない。デプロイ前に現在のアカウントプランと実際の書き出し結果を確認しよう。

Riveには[Editorに組み込まれたAI Agent](https://rive.app/docs/editor/ai-agent)もある。Editorのサイドバーから開き、EditorのプランとAIクレジット条件が適用される。このガイドのフォルダーとターミナルを使う方法は、CLIと組み合わせる外部コーディングエージェントの手順だ。両者はインターフェースも料金体系も異なる。

## 出典・関連資料

- [Rive CLI概要](https://rive.app/docs/cli/overview)：ターミナルでの作業、出力形式、プレビュー、アカウントファイルとのやり取りを説明する。
- [Getting Started](https://rive.app/docs/cli/getting-started)：対応システム、インストール、ひな型の内容、ローカルビルド、サインイン要件を説明する。
- [AIエージェントとの作業](https://rive.app/docs/cli/agents)：コーディングエージェントが生成済みの指示やCLIのフィードバックをどう使うかを示す。[Editor組み込みAgentのガイド](https://rive.app/docs/editor/ai-agent)：独立したEditorインターフェースについて説明する。
- [RMLガイド](https://rive.app/docs/runtimes/advanced-topic/rml)、[コマンドリファレンス](https://rive.app/docs/cli/reference/commands)、[使用例](https://rive.app/docs/cli/examples)は、ファイルの仕組み、正確なコマンド、テスト、キャプチャの挙動、公開時の制限を裏付ける。
- [9月11日のスタッフ発表](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml)：テクニカルプレビュー開始日と、期間限定のCLI無料提供について記載する。[ダウンロードページ](https://rive.app/downloads)では現在CLIをEarly Accessとして掲載し、[料金ページ](https://rive.app/pricing)ではアカウントプランを掲載している。人間とエージェントの作業手順は[Riveの操作動画](https://youtu.be/Y3E33otHeLE)で確認できる。

## Sources

- [Rive CLI概要](https://rive.app/docs/cli/overview) — CLIの目的、ローカルの.rivとEditor用.rivの出力、ライブプレビュー、検査・テスト・キャプチャ機能、リモートファイル連携を定義する。
- [Rive CLI Getting Started](https://rive.app/docs/cli/getting-started) — 対応プラットフォーム、インストール、プロジェクトひな型、プレビュー出力、.revとリモートインポート、ログイン、スクリプト署名、透かし条件を記載する。
- [AIエージェントとの作業](https://rive.app/docs/cli/agents) — 外部エージェント、生成される指示、リファレンス検索、検証、検査、人間が段階的に指示する方法を説明する。
- [Rive Markup Language](https://rive.app/docs/runtimes/advanced-topic/rml) — RML構造、テキスト形式プロジェクトのコンパイル、個別のコンパイル・検査・視覚チェックを定義する。ビルド成功だけでは意図した外観や動作を保証しないと明記する。
- [Rive CLIコマンドリファレンス](https://rive.app/docs/cli/reference/commands) — 正確なコマンドとフラグ、終了コード、リモート送受信、認証、署名、.rev書き出し、クリーンな.rivの条件を確認する一次資料。
- [Rive CLIの例](https://rive.app/docs/cli/examples) — ヘッドレスのスクリーンショット、時間進行、ビューポート、データ、ポインター入力、Luauテスト、JSONレポートを示す。BIG CHANGEは例を実行していない。
- [Rive AI Agent](https://rive.app/docs/editor/ai-agent) — Editorに組み込まれた別のAI Agentと、そのプランおよびAIクレジット条件を説明する。
- [Rive Downloads](https://rive.app/downloads) — 現在のページではRive CLIをEarly Accessとして掲載している。
- [Rive料金プラン](https://rive.app/pricing) — 現在のアカウントとEditor Agentのプラン条件を記載する。日付のあるCLIプレビュー料金とは別に扱った。
- [Rive CLIとRMLの紹介](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — スタッフはCLIの公開をテクニカルプレビューとし、期間中は制限なく無料と発表した。ファイル形式の役割と操作動画へのリンクも含む。
- [Rive CLI操作動画](https://youtu.be/Y3E33otHeLE) — オーナー提供の動画リンク。動画固有のシーンや結果に関する主張はしていない。