Version control
How project history is saved and how to revert changes.
Same automatically saves checkpoints of your project as you work.
Checkpoints
Checkpoints are created automatically:
- After agent actions: When Same edits, creates, or deletes files. The checkpoint is linked to the agent’s message block.
- For user messages: Capturing the project state before your instruction was processed.
This creates a detailed history of your prompts and Same’s actions.
Viewing History
Major versions (created when Same explicitly versions the project) are shown in the Version History panel.
- Click the Clock icon in the top-right of the chat panel.
- A dropdown shows major versions and the latest state.
View version history via the clock icon.
Restoring and Reverting
You can interact with checkpoints associated with user messages and agent actions.
Preview a Checkpoint
Click Restore checkpoint next to a message or action block. This loads a preview of the project state at that point in the workbench (editor, preview, terminal). A green “Current Checkpoint” badge appears next to the restored item.
Click 'Restore checkpoint' to preview a past state.
The green badge indicates the currently previewed checkpoint.
Revert to a Checkpoint
After restoring (previewing) a checkpoint, the button changes to Revert to checkpoint. Clicking this permanently resets the project to that state. All later messages and changes are deleted. Use with caution.
Restoring/reverting a user message loads the state before that message was processed.
Click 'Revert to checkpoint' to permanently restore this state and delete subsequent history.
Return to Latest State (Exit Preview)
If you are previewing an older checkpoint and want to return to the current state without reverting:
- Click the Clock icon.
- Select “Latest changes” at the top. The workbench will reload the most recent project state.
Click 'Latest changes' to exit preview mode and view the current state.
Version control
How project history is saved and how to revert changes.
Same automatically saves checkpoints of your project as you work.
Checkpoints
Checkpoints are created automatically:
- After agent actions: When Same edits, creates, or deletes files. The checkpoint is linked to the agent’s message block.
- For user messages: Capturing the project state before your instruction was processed.
This creates a detailed history of your prompts and Same’s actions.
Viewing History
Major versions (created when Same explicitly versions the project) are shown in the Version History panel.
- Click the Clock icon in the top-right of the chat panel.
- A dropdown shows major versions and the latest state.
View version history via the clock icon.
Restoring and Reverting
You can interact with checkpoints associated with user messages and agent actions.
Preview a Checkpoint
Click Restore checkpoint next to a message or action block. This loads a preview of the project state at that point in the workbench (editor, preview, terminal). A green “Current Checkpoint” badge appears next to the restored item.
Click 'Restore checkpoint' to preview a past state.
The green badge indicates the currently previewed checkpoint.
Revert to a Checkpoint
After restoring (previewing) a checkpoint, the button changes to Revert to checkpoint. Clicking this permanently resets the project to that state. All later messages and changes are deleted. Use with caution.
Restoring/reverting a user message loads the state before that message was processed.
Click 'Revert to checkpoint' to permanently restore this state and delete subsequent history.
Return to Latest State (Exit Preview)
If you are previewing an older checkpoint and want to return to the current state without reverting:
- Click the Clock icon.
- Select “Latest changes” at the top. The workbench will reload the most recent project state.
Click 'Latest changes' to exit preview mode and view the current state.