Command · Compare Versions
history.diff
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.
- v1
- Capability Read
- Tool
history_diff
Request
{
"command": "history.diff",
"params": {
"from": 12,
"to": "current"
}
}Parameters
frominteger | stringRequired- A version id, or "current".
sequenceinteger (1..)- Sequence id; only needed when the project has several.
tointeger | string- A version id, or "current" (default).
Discussion
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. "summary" says it in lines with timecodes.
Run it with wabcut-cli cmd <project> --json, from an MCP client as history_diff, or from an extension. See Edit commands for requests, references and results.
See also
history.*
- history.checkpoint
Save Version. Records the project as it is now in the version history (unchanged since the last version: nothing is added).
- 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).