Plan and run system cutovers (migrations, go-lives, maintenance windows) from a file
that lives next to your scripts in the repository.
A Cutoverly project is a single *.cutoverly file (*.cutoverly.json works too). It uses
the same format as the export of the Cutoverly desktop app:
export a project from the app, keep working on it in VS Code, and import it back at any time.
Features
Project editor — open a .cutoverly file to see the project header (working hours,
item and script counts, active run), the progress of the run and the work item table
with a detail panel. Use { } to see the raw JSON.
Plan and runs — the plan is the template; a run is a snapshot of it with its own
status. Create runs (incl. variants and scope values), switch between them, abort them.
Run it live — start a task, mark it done or failed. Successors become ready, blocked
paths are skipped, parent items and the run complete automatically — exactly like the app.
Sidebar — Projects in the workspace, Work Items of the selected plan/run with filters,
and Next Up: what is running and what can be started now.
Status bar — project, run, progress and current task at a glance.
Edit the plan — add items and child items, delete them, set owner and duration, and connect
predecessors (start on success or on failure). The schedule updates as you type.
Code linkage — drag a script from the Explorer onto a work item (in the Work Items tree, or
hold Shift while dropping into the editor) and open it in one click.
Notes — add notes to work items (instructions authored in the plan are copied into each run).
Git friendly — every change is a plain JSON edit: undo works, and changes show up in diffs and pull requests.
Getting started
Export a project from the Cutoverly app (it saves a .cutoverly file) into your repository — or
run Cutoverly: New Project from the command palette.
Open the file. The Cutoverly editor opens by default.
Pick + New run… in the header to create a run, then work through Next Up.
Settings
Setting
Default
Description
cutoverly.autoSave
true
Save the file automatically after status changes, notes and run actions.
Coming with Cutoverly Pro
Run linked scripts from the work item: exit code sets the status, output is attached as a note.
MCP server for AI assistants (GitHub Copilot, Claude Code, Codex) to read and drive the cutover.
