viberevert

VibeRevert는 AI 코딩 세션을 기록하고, 결정적 규칙으로 위험한 변경을 표시하며, 커밋하지 않은 작업까지 포함해 프로젝트 파일을 세션이 시작되기 전 상태로 정확히 복원할 수 있습니다.

AI가 AI를 심판하지 않습니다: 리스크 판단 결과는 재현 가능하고 설명 가능하며, 직접 살펴볼 수 있는 규칙에 기반합니다.

사용하던 코딩 에이전트를 계속 쓰세요. VibeRevert는 Claude Code, Cursor 및 다른 코딩 에이전트 워크플로와 함께 세션 주변에 안전 계층을 추가합니다.

작동하는 모습

실제 CLI를 베타 결제 실행 결과에서 축약했습니다. check가 위험을 표시하고, rollback이 --apply 전에 변경 내용을 미리 보여줍니다.

$ viberevert check
risk: CRITICAL · payments
  app/api/checkout/route.ts          payments   (critical)
  app/api/webhooks/stripe/route.ts   payments   (critical)

$ viberevert rollback <session>        # preview — nothing changed yet
  package.json                       tracked_restored
  app/page.tsx                       tracked_restored
  app/api/checkout/route.ts          untracked_deleted
  app/api/webhooks/stripe/route.ts   untracked_deleted
  lib/stripe.ts                      untracked_deleted
  .gitignore  README.md  (your uncommitted work)   skipped_unchanged

Related MCP server: uacos

보호 약속이 아니라 증명

실제 AI 코딩 세션 3개. 프로젝트 파일 복원 3건, 정확하게. 결제 처리, 데이터베이스 마이그레이션, 배포 인프라 — 모두 커밋하지 않은 기존 작업을 보존한 채로 이루어졌습니다. 베타 리포트 읽어보기 →

빠른 시작

Git 저장소 안에서 동작하며 Node.js 22+가 필요합니다. VibeRevert는 기록을 사용자 PC에 보관하며 VibeRevert 계정이나 호스팅 서비스가 필요하지 않습니다.

npm install -g viberevert@beta

viberevert init                # one-time setup in your project
viberevert run <your-agent>    # records the session and saves your files' starting state
viberevert check               # see what changed and what looks risky
viberevert rollback <session>  # preview putting your files back; add --apply to restore

무엇으로부터 보호해 주나요

AI 에이전트가 프로젝트 전반에서 작업하도록 했는데, 예상보다 더 많은 곳을 건드렸을 수 있습니다. — 결제 코드, 데이터베이스 마이그레이션, 배포 파일 — 사용자가 만들어 놓은 미완성 작업은 커밋되지 않은 채 그대로 있었을 것입니다. VibeRevert는 먼저 프로젝트의 시작 파일 상태를 캡처하기 때문에, 만족스럽지 못한 세션이 여러분의 오후를 앗아가지 않습니다.

VibeRevert의 방식

VibeRevert는 각 AI 코딩 세션에 대해 다음과 같이 동작합니다.

• 프로젝트를 먼저 체크포인트로 저장 — 커밋하지 않은 작업을 포함한 작업 트리, 스테이징된 변경, 추적되지 않는 파일까지.

• 세션을 기록하고, 세션이 실행되는 동안 변경된 프로젝트 파일을 남깁니다.

• 위험한 수정사항을 표시 — 인증, 결제, 데이터베이스, 비밀 정보, 의존성 또는 인프라를 건드리는 변경(리스크 분류).

• 이 결과를 그 다음 반복에서 바로 사용할 수 있는 에이전트용 수정 프롬프트로 정리합니다.

• 필요할 때 파일을 체크포인트 상태로 복원합니다.

알려줄 뿐, 조용히 작업을 막지는 않습니다. 선택적으로 적용하는 pre-commit 훅이 설정한 위험 임계값을 넘는 커밋을 거부할 수도 있습니다. 다른 로컬 Git 훅처럼 선택 적용, 조절, 우회가 가능합니다.

규칙이 판단하고, 에이전트가 수정합니다

VibeRevert는 다른 언어 모델에게 에이전트의 변경 사항이 위험한지 묻지 않습니다. 판정은 결정적입니다. 동일한 입력과 동일한 설정은 항상 동일한 결과를 만들며, 모든 표시에는 검토 가능한 근거가 있습니다.

주의가 필요한 부분이 있으면, VibeRevert는 그 결과물을 에이전트가 바로 쓸 수 있는 수정 프롬프트로 전환합니다. 무엇을 표시할지는 규칙이 정하고, 나중에 어떻게 할지는 여러분이 정합니다.

롤백이 복원하는 것과 그렇지 않은 것

viberevert rollback은 커밋하지 않은 작업을 포함한 로컬 프로젝트 파일(추적 중, 후보 스테이지, 비추적 파일)을 세션이 시작됐을 때의 상태로 복원합니다. 기본적으로 먼저 미리보기를 보여 주며, --apply는 변경 사항을 적용하기 전에 응급 체크포인트를 저장합니다.

프로젝트 파일 밖의 효과는 되돌리지 않습니다. 배포, 데이터베이스 쓰기, 제3사 API 호출, 결제, 발송된 이메일은 자체적으로 복구해야 합니다. 롤백은 원자적이라기보다 상태 기반이며, AI 세션의 안전망이지 테스트나 리뷰를 대체하지 않습니다. 신뢰하고 사용하기 전에 롤백이 복원할 수 있는 것과 없는 것을 읽어 보세요.

다양한 코딩 에이전트에 빠는 하나의 복구 계층

선호하는 코딩 도구를 계속 사용하세요. VibeRevert는 CLI 에이전트 세션을 비교 범위로 감쌀 수 있고(viberevert run <your-agent>), 설치 프로그램을 통해 Claude Code 및 Cursor 같은 도구와 통합할 수 있습니다.

내장 체크포인트온 에이전트 워크플로우 안에 살아 있습니다. VibeRevert는 프로젝트에 남아 있습니다.

프로젝트 시작 상태(커밋하지 않은 작업 포함)를 잡고, 세션을 기록하며, 위험 변경을 표시하고, 롤백을 미리 보여 주며 이후에도 그 복구 경로는 에이전트 바깥에 보존됩니다.

오늘은 Claude Code를, 내일은 Cursor를 쓰거나 다른 터미널 에이전트를 감쌀 수도 있습니다: 안전 계층은 프로젝트와 함께합니다.

도구에 연결하기

VibeRever트는 비파괴적으로 설치되며 깨끗하게 제거할 수 있습니다. Claude Code and Cursor(MCP server 및 hooks)와 통합되며, 모든 설치 과정은 변경 사항을 미리 보여 줘고 복구 저널을 유지합니다. 시작하기를 참조하세요.

실험적인 터미널 브리지(\--pty)는 대화형 에이전트 셸 안에서 명령을 가로챌 수 있습니다. Best-effort 방식이며, PTY 계약에 그렇게 문서화되어 있습니다.

지원 플랫폼

Linux, macOS, Windows, Node.js 22+ 대상입니다. CI는 세 플랫폼 모두에서 Node 22와 24를 대상으로 전체를 실행합니다. 각 플랫폼이 정확히 수준에서 테스트되므로 호환성을 확인하세요.

더 알아보기

• 시작하기 · 명령어 · 설정

• 롤백이 되돌릴 수 있는 것과 없는 것 · 위험 분류

• 보안 정책 · 위협 모델 · 기여하기

VibeRevert를 후원하세요

VibeRevert는 Apache-2.0 오픈소스입니다. 후원금은 지속적인 데스크톱 플랩폼 테스트, 보안 작업, 롤백 시나리오 테스트, 독립적 검토 비용에 사용됩니다. 후원이 보안 위험 판정이나 출시 결정에 영향을 미치지 않습니다. → VibeRevert 후원하기 · 후원금의 활용

라이선스

Apache-2.0. NOTICE 및 라이선스 감사를 참조하세요.