Skip to content

Save a local version

Save Local Version saves a checkpoint of your work on your machine without publishing it and without releasing your lock. Use it for restore points mid-task before you're ready to share.

Prerequisites

  • You hold the lock (Checked out by me) on the file.
  • You have saved the file in SolidWorks (so there's a change to checkpoint).

Steps

  1. In the Files tab, find the checked-out file.
  2. Right-click the file → Save Local Version icon Save Local Version.

Expected result

  • The file gains an L badge with a number: L1 for your first local version, L2 for the next, and so on.
  • Your lock stays held; the file stays writable; nothing is published to the team yet.

Publishing local versions later

When you're ready to share, check in. Check In publishes the file (with a Squash / Keep separate choice for its local versions) and releases the lock — this does not create a snapshot. After a successful check-in the L badge clears. To mark a whole-repo milestone, use Publish a snapshot.

Discarding local versions

If you decide not to keep your work, undoing the check-out discards unpublished local versions. GitM warns you first, because this cannot be undone.

Troubleshooting

Symptom Cause Fix
L badge persists after a successful check-in Known stale-count issue (fixed) — the count is the number of local commits not yet on GitHub. Refresh the task pane; the badge clears once the count re-reads as zero.
Save Local Version does nothing No saved change since the last version. Save in SolidWorks first.

Known limitations

  • Local versions live only on your machine. They are stored in .gitm/local-versions.json, which is per-machine and never tracked. If you lose the machine before checking in, unpublished local versions are gone.
  • Releasing a lock or discarding a file drops unpublished local versions (with a warning).

See also: Versions and snapshots.