Rewind file changes with checkpointing changedagent-sdk/file-checkpointing
Nearest release: v2.1.284, published 16 hours after upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 28 Sep 2026 00:41 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 28 Sep 2026 23:37 UTC.
Upstream edited
Recorded here
Lines+10added
Lines−10removed
From line
140
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits9to this page, all time
The whole hunk
from line 140, old and new numbered
/
from line 140
140140 <Step title="Enable checkpointing">
141141 Configure your SDK options to enable checkpointing and receive checkpoint UUIDs:
142142
143 | Option | Python | TypeScript | Description |
144 | ------------------------ | ------------------------------------------- | --------------------------------------------- | ------------------------------------------------ |
145 | Enable checkpointing | `enable_file_checkpointing=True` | `enableFileCheckpointing: true` | Tracks file changes for rewinding |
143 | Option | Python | TypeScript | Description |
144 | - | - | - | - |
145 | Enable checkpointing | `enable_file_checkpointing=True` | `enableFileCheckpointing: true` | Tracks file changes for rewinding |
146146 | Receive checkpoint UUIDs | `extra_args={"replay-user-messages": None}` | `extraArgs: { 'replay-user-messages': null }` | Required to get user message UUIDs in the stream |
147147
148148 <CodeGroup>
from line 699
699699
700700File checkpointing has the following limitations:
701701
702| Limitation | Description |
703| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
704| Write/Edit/NotebookEdit tools only | Changes made through Bash commands are not tracked |
705| Subagent edits | Edits a [subagent](/docs/en/agent-sdk/subagents) applies aren't tracked or restored, except a skill with `context: fork` running in the foreground; use git to revert untracked edits |
706| Same session | Checkpoints are tied to the session that created them |
707| File content only | Creating, moving, or deleting directories is not undone by rewinding |
708| Local files | Remote or network files are not tracked |
702| Limitation | Description |
703| - | - |
704| Write/Edit/NotebookEdit tools only | Changes made through Bash commands are not tracked |
705| Subagent edits | Edits a [subagent](/docs/en/agent-sdk/subagents) applies aren't tracked or restored, except a skill with `context: fork` running in the foreground; use git to revert untracked edits |
706| Same session | Checkpoints are tied to the session that created them |
707| File content only | Creating, moving, or deleting directories is not undone by rewinding |
708| Local files | Remote or network files are not tracked |
709709
710710## Troubleshooting
711711
No line in this hunk matches that.