Command · Save Version
history.checkpoint
Records the project as it is now in the version history (unchanged since the last version: nothing is added).
- v1
- Capability EditProject
- Tool
history_checkpoint
Request
{
"command": "history.checkpoint",
"params": {
"label": "Client cut v2"
}
}Parameters
kind`save` | `auto` | `agent` | `manual` | `restore`- What made it (default manual).
labelstring- A name for the version.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
Discussion
Records the project as it is now in the version history (unchanged since the last version: nothing is added). Give "label" to name it ("Client cut v2"): named versions are never pruned. Hosts call it on save, every few minutes of editing and before an AI agent applies a plan (kind).
Run it with wabcut-cli cmd <project> --json, from an MCP client as history_checkpoint, or from an extension. See Edit commands for requests, references and results.
See also
history.*
- history.diff
Compare Versions. What changed from one version to another ("current" is the project as it is): per sequence the clips added, removed, moved, trimmed or retimed, effects and keyframes changed, settings, tracks, markers and captions; media and review notes.
- history.export
Save Version As. Writes a saved version as a project file of its own ("restore as a new project").
- history.list
Version History. The project's saved versions, oldest first, as arrays: id, createdAt (UTC), kind (save, auto, agent, manual, restore), label (named versions are kept), sequences, clips, the bytes the version added.
- history.name
Name Version. Names a saved version (an empty label unnames it).
- history.restore
Restore Version. Goes back to a saved version: the whole project (one undo step; the project as it was is saved as a version first), or, with "sequence", that sequence of the version as a new sequence next to the current ones (the media it plays is the project's own where the project still has it).