TL;DR

  • Rivet은 팀과 코딩 에이전트가 계획을 검토하고, 격리된 Git 체크아웃에서 작업하며, 프로젝트 검사를 실행하고, 결과를 검토한 뒤 전달하는 공유 개발 워크플로임.
  • macOS 또는 Linux에서 Node.js 22 또는 24와 Git을 설치하고 Yarn Classic, npm, pnpm 중 하나로 전역 설치함.
  • rivet setup, rivet setup --write, rivet doctor로 설정을 미리 검토하고 적용한 뒤, 필요한 검사를 해결하고 설정을 커밋함.
  • 인증된 Claude Code 또는 Codex CLI와 rivet run, rivet task status, rivet task approve를 사용해 작업을 수행하고 확인함.
  • Rivet은 현재 알파 소프트웨어이며 npm의 @agilno-tech/rivet에서 제공되고, Apache 2.0 라이선스를 적용함.

개요

  • Rivet은 팀과 코딩 에이전트를 위한 공유 개발 워크플로임.
  • 계획 검토, 격리된 Git 체크아웃에서의 작업, 프로젝트 검사 실행, 결과 검토 후 전달을 지원함.
  • 코딩 하네스(coding harness) 또는 터미널에서 Rivet을 사용함.

시작하기

  • macOS 또는 Linux에 Node.js 22 또는 24와 Git을 설치한 뒤 패키지 관리자 하나를 선택함.
  • Yarn Classic 1.22에서는 yarn global add @agilno-tech/rivet을 실행함.
  • npm에서는 npm install --global @agilno-tech/rivet을 실행함.
  • pnpm에서는 pnpm add --global @agilno-tech/rivet을 실행함.
  • 설치 명령 하나를 사용함. 최신 Yarn은 yarn global을 제공하지 않으므로 전역 CLI 설치에는 npm 또는 pnpm을 사용함. PATH 설정은 설치 안내를 참조함.
  • 프로젝트 루트에서 rivet setup, rivet setup --write, rivet doctor를 실행함.
  • 적용 전에 설정 미리보기를 검토함. 필수 검사를 해결하고 설정을 커밋함.
  • 인증된 Claude Code 또는 Codex CLI가 설치된 경우 rivet run "Add a GET /health endpoint with a regression test"로 작업을 실행하고, rivet task status로 상태를 확인하며, rivet task approve로 승인함.
  • 검증 후 Rivet은 차이(diff) 검토, 로컬 적용, 풀 리퀘스트 전달 준비, 작업 보류를 위한 메뉴를 제공함.
  • 로컬 적용은 확인을 거친 뒤 검증된 커밋으로 깨끗한 기본 브랜치를 갱신함. 게시 승인은 별도로 진행함.
  • 저장된 상태에서 계속하려면 rivet task resume을 사용하며, 필요한 경우 번호로 작업을 선택함.
  • 또는 코딩 하네스에 Rivet 스킬을 읽고 작업을 완료하도록 요청함. Rivet은 프로젝트를 감지하고 승인을 요청하며 검증 결과를 검토용으로 보관함.
  • Node.js는 Rivet 자체를 실행함. 구성된 검사와 의존성 명령을 사용하면 애플리케이션은 Python/Django, Node.js 또는 다른 언어로 작성할 수 있음.
  • Rivet은 npm에서 @agilno-tech/rivet으로 알파 버전을 제공함. 기본 설치는 npm의 최신 태그를 선택하며, Rivet은 아직 알파 소프트웨어임.
  • Rivet의 라이선스는 Apache 2.0임. 테스트된 환경과 제한 사항은 호환성 안내를 참조함.

문서

  • 빠른 시작
  • 구성 및 명령
  • 통합
  • 검토 및 전달
  • 문제 해결
  • 기여
  • 사람이 읽을 수 있는 오류 메시지는 이용 가능한 경우 비공개 진단 보고서 경로를 표시함.
  • 더 광범위한 비식별 진단 정보를 저장하려면 rivet support --save를 사용하며, 공유 전에 보고서를 확인함.
  • 문제나 개선 사항은 이슈 또는 풀 리퀘스트로 제출함. Rivet은 Agilno가 개발함.