Skip to main content
セッションと変更の管理

取り消しと復元

概要

Qoderとの協業において、以前の状態に戻りたいと思うことがあるかもしれません。直近の一連の変更を取り消したり、会話を以前の時点に戻してやり直したりする場合です。Qoder CLIは巻き戻し機能を通じてこの機能を提供します。会話内のユーザーメッセージをチェックポイントとして、会話、ファイル変更、またはその両方を以前の状態に復元できます。

巻き戻し(/rewind)

/rewind を使用して巻き戻しインターフェースを開きます:
/rewind
巻き戻しインターフェースには、会話内のチェックポイント(送信したユーザーメッセージをマーカーとします)が一覧表示されます。チェックポイントを選択すると、Qoderはその時点への巻き戻しによる影響を表示し、確認を求めます。

復元対象

巻き戻しを確認する際、復元範囲を選択できます:
  • 会話とファイルの復元(デフォルト):会話をチェックポイントまで復元し、同時にその時点以降にQoderによって行われたファイル変更もすべて元に戻します。
  • 会話のみ復元:会話履歴をチェックポイントまで復元し、ファイルは現在の状態のまま維持します。
  • ファイルのみ復元:その時点以降にQoderによって行われたファイル変更を元に戻し、会話は現在の状態のまま維持します。
巻き戻しインターフェースには、ファイルを復元する場合の対象ファイル数、および追加・削除される行数が表示されます(例:「今巻き戻すと、3つのファイルが復元されます(+42 -17)」)。これにより、確認前に関連する影響範囲を把握できます。
手動編集やシェルコマンドによるファイル変更は、巻き戻しによって復元されない場合があります。巻き戻しは、主にQoderがファイル編集ツールを介して行った変更を対象としています。

仕組み

Qoder CLIはセッション中にファイル編集履歴を記録します。各チェックポイントは会話内の1つのユーザーメッセージに対応し、Qoderはそれ以降に行われたファイル変更を追跡します。特定のチェックポイントへの巻き戻しを選択すると:
  • 会話の復元を選択した場合、会話履歴はそのチェックポイントまで切り捨てられます。
  • ファイルの復元を選択した場合、Qoderは記録された編集履歴に基づき、関連ファイルをそのチェックポイント時点の状態に復元します。
あるチェックポイントに復元可能なファイル変更がない場合、巻き戻しインターフェースには「会話が復元されますが、ファイル変更は含まれません」と明確に提示されます。

使用タイミング

巻き戻しは以下のような状況に適しています:
  • Qoderが誤った方向に進んでしまい、分岐点に戻って要件を再説明したい場合。
  • 直近の一連の変更が思わしくなく、素早く元に戻して別のアプローチを試みたい場合。
  • 会話の早い時点から再度展開し、異なるソリューションを試みたい場合。
元のセッションを保持したまま、ある時点から新しい方向性を模索したい場合は、セッションブランチの使用も検討してください。セッション管理を参照してください。巻き戻しは「その場で過去に戻る」ことであり、ブランチは「過去から新しい道を分岐させる」ことです。

ヒント

  • 巻き戻しを行う前に、インターフェースに表示されるファイルへの影響範囲を確認し、復元したい内容が期待通りであることを確認してください。
  • 重要な変更が関わる場合は、Gitと併用するとより安全です。重要な時点でコミットを行うことで、巻き戻しの対象範囲外であっても復元が可能になります。
  • 巻き戻しは現在のセッション内で記録された編集履歴のみを対象としており、セッションをまたぐ変更や、手動またはシェルコマンドによる変更は対象外です。
Qoder CLI を使用する