Cursor の Restore Checkpoint で Agent の変更を元に戻す手順: 戻るものと戻らないもの
Cursor の Agent が書き換えたファイルを、Restore Checkpoint で元に戻す手順をメモしました。戻るのは Agent が編集したファイルだけで、Agent がターミナルで作ったファイルと git commit は残るので、残ったものは Git で戻します。
経緯
Agent にファイルの編集、ターミナルでのファイルの作成、git commit をまとめて頼み、そのあとに Restore Checkpoint で戻しました。すると、編集したファイルは元に戻りましたが、ターミナルで作ったファイルとコミットはそのまま残っていました。
Agent には、次のように頼みました。
textsrc/calculator.js の subtract 関数を、割り算をする divide 関数に書き換えてください。次に、ターミナルで CHANGELOG.md を作って変更内容を1行書いてください。最後に、変更をすべてコミットしてください。
環境
- macOS 26.6
- Cursor 3.27.22(Free プラン)
手順
Restore Checkpoint を押す
Agent への指示にマウスを合わせると、右下に矢印のボタンが出ます。マウスを合わせると Restore Checkpoint と表示されるので、クリックします。
Continue を押す
次の確認が出るので、Continue を押します。
textDiscard all changes up to this checkpoint?
You can always undo this later.
戻したあとは、指示の文が入力欄に戻り、その下に Redo checkpoint が出ます。Redo checkpoint を押すと、戻す前の状態に戻ります。
戻らなかったものを git status で見る
Restore Checkpoint のあとは、次のようになりました。
| Agent がしたこと | Restore Checkpoint のあと |
|---|---|
src/calculator.js を編集した | 元に戻った |
ターミナルで CHANGELOG.md を作った | 残った |
git commit をした | 残った |
コミットは残ったまま、src/calculator.js だけが前の内容に戻るので、ファイルとコミットが食い違った状態になります。
terminal$ git status --short
M src/calculator.js
Agent のコミットを取り消す
コミットごと取り消すときは、Git で戻します。一番上が Agent のコミットです。
terminal$ git log --oneline
fec67aa subtract を divide に置き換え、変更内容を CHANGELOG に記録する
d478459 計算の関数を追加
取り消すとそのコミットの変更は消えるので、先に git show fec67aa で中身を見てから戻します。
terminal$ git reset --hard HEAD~1
すでに push したコミットは、git reset ではなく git revert で打ち消します。
ターミナルで作られたファイルを消す
git status --short で、?? の付いたファイル(Git で管理していないファイル)を見て、要らないものを消します。Agent がコミットまでしていたときは、上のコミットの取り消しで一緒に消えます。
注意点
参考文献
著書
使い方Cursor の Claude Code 拡張機能 2.1.312、2.1.313 の不正な版: 拡張機能を消しても、まだ裏で動いている
使い方Cursor の Restore Checkpoint で Agent の変更を元に戻す手順: 戻るものと戻らないもの
使い方Cursor で過去のチャット(Agent の会話)を探す手順: Cmd + K の検索と Cmd + F
トラブルシュート【解決方法】Cursor が重い、遅いときの原因と対処: 拡張機能を止めて比べる
トラブルシュートCursor エディタ:キャッシュクリアで動作改善!Windows/Mac での手順とマウスカーソルの直し方
使い方Cursor コスト最適化:トークン節約・キャッシュ・差分駆動で費用を半減
使い方Orca の使い方: Claude Code のサブスクリプションのまま使える。最初に変える設定は権限
チートシートCodex の料金プラン一覧: Plus の5時間の枠は、GPT-6.1 Sol で応答160〜200回だった
挙動Codex の sandbox の設定: read-only でも .env は読める。モードごとにできること
チートシートClaude Code のスラッシュコマンド一覧: 2.1.311 の / に出るコマンドを、用途別に並べた
チートシートOllama のコマンド一覧: run は、入っていないモデルなら pull から始める。よく使う10個の違い
使い方Mermaid CLI(mmdc)のインストールと使い方: 10枚の図は、1つの Markdown にまとめると4倍速く書き出せた


