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 は記録をあなたのマシン上に保持し、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 が行うこと

AI コーディングセッションの各回について、VibeRevert は:

• まずプロジェクトをチェックポイントします — コミットしていない作業も含め、ワーキングツリー、ステージング済み変更、未トラックファイル。

• セッションを記録し、その間に変更されたプロジェクトファイルも記録します。

• リスクのある編集にフラグを立てます — 認証、決済、データベース、シークレット、依存関係、インフラに触れる変更（リスク分類）

• その検出結果から次回合わせに貼り付けられるエージェント向け修正プロンプトを生成します

• 必要なときにファイルをチェックポイントへ復元します

これはあなたに警告するもので、黙って操作を妨げることはありません。オプションの pre-commit フックを使えば、設定したリスクしきい値を超えるコミットを拒否できます。オプトインで調整可能、ほかのローカル Git フックと同じくバイパスもできます。

ルールが判定し、エージェントが修正する

VibeRevert は、別の言語モデルに「エージェントの変更はリスクに見えるか」を質問しません。チェックは決定的です。同じ入力と設定からは常に同じ検出不都合が得られ、それぞれのフラグには検証可能な理由があります。

何かに注目が必要なとき、VibeRevert はその検出結果を、エージェントに即つかえる修正プロンプトへ翻訳します。何をフラグするかを決めるのはルール、次にどうするかを決めるのはあなたです。

ロールバックで復元されるもの — されないもの

viberevroll は ローカルプロジェクトファイル — 追跡済み、ステージ済み、未そして未追跡のファイル（コミットしていない作業を含む）— を、セッションが始まった時点の状態へ要件します。デフォルトではプレビューのみを行われ、実際に反映するには --apply し、適用のたびにまず緊急チェックポイントへ保存されます。

プロジェクトファイルの外へ及んだ影響は元に戻しません。デプロイ、データベースへの書き込み、第三者が提供する API 呼び出し、決済、送信済みメールは、それぞれ法文の復旧処理が必要です。ロールバックは原子処理ではなく、状態ベースのものです。AI セッションを待つ守りの網であり、テストやレビューの代わりではないません。実際にこれを当てにする前に ロールバックが復元できることや勿論をご読んでください。

コーディングエージェントをつなぐ 1 つの復元レイヤー

好みのコーディングツールをそのまま使ってください。VibeRevert はコマンドラインのエージェントセッションをラップできる。 (viberevert run <your-agent>) します。導入セットアップを通じて Claude Code や Cursor といったツールとも連携します。

ビジルトインのチェックポイントはエージェントのワークフロー内部に存在します。VibeRevert はプロジェクトとともにある。

プロジェクトの初期状態（コミットしていない作業を含む）を取り込み、セッションを記録し、リスクのある変更をフラグし、ロールバックをプレビューし、その復旧経路をエージェント側の外側に保持し続けます。

今日は Claude Code、明日は Cursor、その他のターミナルエージェントをラップする — セーフティレイヤーはプロジェクトに残ります。

ツールへの組み込み

VibeRevert は非破壊的にインストールされ、清潔にはがすことができます。Claude Code と Cursor（MCP サーバーとフック）に統合されており、どのインストールも変更内容をプレビューし、復旧ジャーナルを保持します。基本 をご確認ください。

実験的 なターミナルブリッジ (--pty) は、対話型エージェントシェル内のコマンドを確認できます。ベストエフォートであり、その旨が [PTY 契約]に明記されています。(docs/pty-contract.md)。

対応プラットフォーム

Linux・macOS・Windows で動作し、Node.js 22+ を対応し。CI は3環境すべてで Node 22 と 24 を使用してスイートを実行しています。各プラットフォームで検証済みの範囲の定義は 互換性 を参照してください。

もっと学ぶ

• はじめに · コマンド · 設定

• ロールバックが復元できるもの・できないもの · リスク分類

• セキュリティポリシー · 脅威モデル · コントリビューション

VibeRevert を支援する

VibeRevert は Apache-2.0 のオープンソースです。スポンサー資金は、継続的なクロスプラットフォームテスト、セキュリティ作業、ロールバック評価とリカバリテスト、独立したレビュー費用に使わります。スポンサー行為が、リスク検出結果やリリースの判断に働きかけることはありません完成。 → VibeRevert をスポンサーする · 支援が反映された使われ方

ライセンス

Apache-2.0 に基づきます。NOTICE と ライセンス監査 もご覧ください。