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

# Rive CLI와 코딩 에이전트 실전 안내

> 코딩 에이전트와 Rive CLI, 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일 확인 당시 CLI를 **Early Access**로 표시한다.

이 체크리스트는 [Rive 문서](https://rive.app/docs/cli/overview)를 따른다. BIG CHANGE는 문서만 검토했다. CLI를 설치하거나 파일을 빌드하거나 에이전트가 만든 그래픽을 시험하지 않았다. Rive의 [영상 안내](https://youtu.be/Y3E33otHeLE)는 사람과 에이전트가 함께 작업하는 방식을 보여준다.

## 큰 변화

- **달라진 점:** Rive 장면을 코딩 에이전트가 텍스트로 작업할 수 있는 경로가 생겼다. 에이전트는 프로젝트 폴더에서 RML을 편집하고 CLI는 런타임용 `.riv` 파일이나 편집기에서 계속 작업할 `.rev` 파일을 컴파일한다.
- **중요한 이유:** 디자이너와 프런트엔드 또는 게임 개발자는 다른 프로젝트 파일과 함께 소스 변경사항을 검토하고 CLI 검사 기능을 반복 작업에 활용할 수 있다. 제품에 에셋을 사용하기 전에는 렌더링된 디자인과 상호작용을 직접 판단해야 한다.
- **지켜볼 점:** 로컬 프로토타입을 웹에 올리는 것은 별도의 결정이다. 스크립트가 포함된 파일은 서명된 `--publish` 빌드가 필요하다. 깨끗한 `.riv`에도 계정 파일 연결과 Cadet 이상 워크스페이스가 필요하다. 배포 전 이 조건과 최종 그래픽을 확인해야 한다.

## 문서에 나온 작업 순서

1. **접근 권한을 확인하고 설치한다.** Rive는 Apple Silicon 기반 macOS, Linux x86\_64, Windows를 지원한다고 안내한다. [시작하기 안내](https://rive.app/docs/cli/getting-started)에는 Windows와 macOS/Linux의 설치 방법이 각각 나와 있다. 해당 페이지의 최신 Windows 안내를 사용한다. 설치 후 `rive doctor`를 실행한다. 명령어 참고 문서에는 `rive --version`; 실제 설치한 버전을 기록하자. 이 CLI는 프리뷰 소프트웨어다. Rive는 9월 11일 발표에서 CLI가*프리뷰 기간에는*제한 없이 무료라고 밝혔다. 이 날짜가 명시된 발표가 CLI의 영구 가격을 확정하지는 않는다. Rive의 [현재 요금제 표](https://rive.app/pricing)는 Rive 계정과 편집기 내장 에이전트에 관한 내용이므로 공개 전에 최신 조건을 확인한다.
2. **텍스트 프로젝트를 만들고 미리보기를 연다.** `rive create myproject` 명령은 `scene.rml`, `rive.yaml`, 에이전트 지침 파일 `AGENTS.md`와 `CLAUDE.md`, 그리고 `.gitignore`를 만든다. 터미널 하나에서 `rive myproject`를 실행한다. Rive에 따르면 이 명령은 폴더를 감시하고 저장할 때마다 다시 빌드해 `myproject/build/myproject.riv`를 쓴다. 시작 장면에는 아트보드와 타임라인, 상태 머신이 있지만 아직 그려진 것은 없다. 처음 미리보기에는 어두운 사각형만 보인다.
3. **코딩 에이전트에 프로젝트 폴더와 구체적인 디자인 작업을 맡긴다.** Rive의 [AI 에이전트 안내](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 편집기에서 열어 수정할 수 있다. Rive에 따르면 로컬 생성과 미리보기, 검증, 테스트와 스크린샷은 로그아웃 상태와 오프라인에서도 작동한다. `rive login` 로그인은 `--publish`, `--rev`, `rive push`, `rive pull` 및 원격 계정 파일 가져오기에 필요하다. 편집기 백업으로 내보낸 파일에서 시작하려면 로그인 없이 `rive create myproject --from-rev=myfile.rev`를 사용할 수 있다. 계정 파일에서 시작하려면 로그인한 뒤 `rive create myproject --from-remote-file`를 사용한다. 이 방식은 프로젝트를 해당 파일에 연결한다. `rive push myproject`는 리비전을 업로드하고, `rive pull myproject`는 편집기 변경사항을 내려받아 **로컬 장면과 스크립트, 에셋을 덮어쓴다**는 확인을 거친 뒤 실행된다. 가져오기 전에 로컬 변경사항을 검토한다.
8. **배포 전에 서명과 내보내기 제한을 확인한다.** `rive myproject --publish`는 서명된 `.riv`를 쓰며 로그인이 필요하다. Rive에 따르면 웹 런타임과 CDN은 서명되지 않은 스크립트를 거부하므로 웹용 스크립트가 든 파일은 이 경로를 사용해야 한다. `--publish`에는 워터마크가 추가될 수 있다. Rive의 [명령어 참고 문서](https://rive.app/docs/cli/reference/commands)는 깨끗한 `.riv`를 만들려면 프로젝트를 `rive push`로 계정 파일에 연결하고 그 파일이 Cadet 이상 워크스페이스에 있어야 한다고 설명한다. 장면에 스크립트가 없더라도 워터마크 조건은 적용된다. `--rev=<path>`도 로그인이 필요하며 `--once` 또는 `--publish`와 함께 쓸 수 있다. 이 옵션은 런타임 파일이 아니라 편집기 파일을 만든다. 배포 전에 현재 요금제와 실제 내보내기 결과를 확인한다.

Rive 편집기에는 별도의 [편집기 내장 AI 에이전트](https://rive.app/docs/editor/ai-agent)가 있다. 편집기 사이드바에서 열 수 있으며 편집기 요금제와 AI 크레딧 조건이 적용된다. 이 안내서의 폴더·터미널 방식은 CLI와 코딩 에이전트를 함께 쓴다. 두 에이전트 경로는 인터페이스와 청구 조건이 다르다.

## 출처 및 더 읽을거리

- [Rive CLI 개요](https://rive.app/docs/cli/overview)는 터미널 작업 방식과 출력 형식, 미리보기 및 계정 파일 교환을 설명한다.
- [시작하기](https://rive.app/docs/cli/getting-started)에는 지원 시스템과 설치, 프로젝트 뼈대 내용, 로컬 빌드, 로그인 조건이 나온다.
- [AI 에이전트와 작업하기](https://rive.app/docs/cli/agents)는 코딩 에이전트가 생성된 프로젝트 지침과 CLI 피드백을 사용하는 방법을 보여준다. [편집기 내장 에이전트 안내](https://rive.app/docs/editor/ai-agent)는 별도의 편집기 인터페이스를 설명한다.
- [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 및 편집기용 .rev 출력, 실시간 미리보기, 검사·테스트·캡처 기능, 원격 파일 교환을 설명한다.
- [Rive CLI 시작하기](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) — Rive 편집기에 별도로 내장된 에이전트와 편집기 요금제 및 AI 크레딧 조건을 설명한다.
- [Rive 다운로드](https://rive.app/downloads) — 현재 페이지에서 Rive CLI를 Early Access로 표시한다.
- [Rive 요금 안내](https://rive.app/pricing) — 현재 계정 및 편집기 에이전트 요금 조건을 제시한다. 날짜가 명시된 프리뷰 CLI 가격 설명과는 별도로 다뤘다.
- [Rive CLI와 RML 소개](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Rive 직원 발표는 출시를 기술 프리뷰라고 부르며 프리뷰 기간 CLI를 제한 없이 무료로 제공한다고 말한다. .riv, .rev, RML의 역할을 설명하고 영상 안내를 연결한다.
- [Rive CLI 영상 안내](https://youtu.be/Y3E33otHeLE) — 소유자가 제공한 영상 링크로 본문과 출처에 포함했다. 영상에서 특정 장면이나 결과를 주장하지 않았다.