Rive의 새로운 CLI를 이용하면 코딩 에이전트가 대화형 그래픽을 프로젝트 파일로 작업할 수 있다. 에이전트는 Rive Markup Language(RML)와 Luau 스크립트, 셰이더를 작성한 뒤 CLI에 결과물의 컴파일과 검사, 테스트, 렌더링을 요청할 수 있다. 사람은 로컬 미리보기를 보고 디자인을 수정할 수 있다. Rive 직원들은 CLI를 9월 11일 기술 프리뷰로 발표했다. Rive 다운로드 페이지는 9월 27일 확인 당시 CLI를 Early Access로 표시한다.

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

큰 변화

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

문서에 나온 작업 순서

  1. 접근 권한을 확인하고 설치한다. Rive는 Apple Silicon 기반 macOS, Linux x86_64, Windows를 지원한다고 안내한다. 시작하기 안내에는 Windows와 macOS/Linux의 설치 방법이 각각 나와 있다. 해당 페이지의 최신 Windows 안내를 사용한다. 설치 후 rive doctor를 실행한다. 명령어 참고 문서에는 rive --version; 실제 설치한 버전을 기록하자. 이 CLI는 프리뷰 소프트웨어다. Rive는 9월 11일 발표에서 CLI가프리뷰 기간에는제한 없이 무료라고 밝혔다. 이 날짜가 명시된 발표가 CLI의 영구 가격을 확정하지는 않는다. Rive의 현재 요금제 표는 Rive 계정과 편집기 내장 에이전트에 관한 내용이므로 공개 전에 최신 조건을 확인한다.
  2. 텍스트 프로젝트를 만들고 미리보기를 연다. rive create myproject 명령은 scene.rml, rive.yaml, 에이전트 지침 파일 AGENTS.md와 CLAUDE.md, 그리고 .gitignore를 만든다. 터미널 하나에서 rive myproject를 실행한다. Rive에 따르면 이 명령은 폴더를 감시하고 저장할 때마다 다시 빌드해 myproject/build/myproject.riv를 쓴다. 시작 장면에는 아트보드와 타임라인, 상태 머신이 있지만 아직 그려진 것은 없다. 처음 미리보기에는 어두운 사각형만 보인다.
  3. 코딩 에이전트에 프로젝트 폴더와 구체적인 디자인 작업을 맡긴다. Rive의 AI 에이전트 안내는 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 안내는 빌드가 성공해도 그래픽의 모양이나 동작이 의도에 맞는다는 뜻은 아니라고 경고한다.
  5. 중요한 상태를 캡처한다. rive myproject --screenshot=out.png는 창 없이 PNG를 렌더링한다. Rive의 예제에서는 애니메이션이 시작된 뒤의 프레임에 --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의 명령어 참고 문서는 깨끗한 .riv를 만들려면 프로젝트를 rive push로 계정 파일에 연결하고 그 파일이 Cadet 이상 워크스페이스에 있어야 한다고 설명한다. 장면에 스크립트가 없더라도 워터마크 조건은 적용된다. --rev=<path>도 로그인이 필요하며 --once 또는 --publish와 함께 쓸 수 있다. 이 옵션은 런타임 파일이 아니라 편집기 파일을 만든다. 배포 전에 현재 요금제와 실제 내보내기 결과를 확인한다.

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

출처 및 더 읽을거리