Back to blog
March 2, 2026 · 6 min read

Never Lose Work —
Version History, Diffs, and One-Click Revert

VS
Varinder Singh
Founder, Claspt
Markdown file icon with Git branch visualization

You deleted a paragraph you now want back. You overwrote a credential with the wrong value. You want to see what your project notes looked like three weeks ago. Most note apps offer "undo" but not true version history. Claspt uses real Git under the hood — every save is a commit, every page has a full history, and you can revert to any point with one click.

Real Git, Not a Custom Undo Stack

When Claspt says "version history," it means an actual Git repository. Your vault is initialized as a Git repo when you create it. Every time you save a page, Claspt creates a Git commit with the changes. This is not a proprietary undo system — it is the same version control that powers every major software project in the world.

Why does this matter? Because Git is proven, reliable, and transparent. You can open your vault directory in a terminal and run git log to see every change ever made. The version history is not locked inside the app.

What the Diff Viewer Shows

Open any page's history and you see a timeline of changes. Click on any commit to see the diff — a side-by-side comparison showing exactly what was added, removed, or modified.

  • Added text is highlighted in green. You can see the exact paragraph, heading, or bullet point that was inserted.
  • Removed text is highlighted in red. You can see what was deleted and decide if you want it back.
  • Encrypted blocks show as "Secret block modified" without revealing the contents. You know a credential changed, but the old value is not exposed in the diff.
  • Timestamps are on every commit. You can see not just what changed, but when.

One-Click Revert

Found a version you want to restore? Click the revert button. Claspt restores the page to that exact state and creates a new commit recording the revert. Your history is never destroyed — the revert itself is a tracked change.

This is especially valuable for credential management. If you accidentally overwrite an API key with the wrong value, you can revert to the previous version and get the correct key back. No "contact support" needed. No "check your backup." Just click revert.

Merge Conflicts

If you use cross-device sync and edit the same page on two devices before they sync, you might create a conflict. Claspt includes a merge conflict viewer (Pro) that shows both versions side by side and lets you choose which changes to keep.

This is a rare scenario — real-time push sync (Pro+) prevents most conflicts — but when it happens, you get a proper tool to resolve it instead of a "conflict copy" file cluttering your vault.

Changes from the API Are Tracked Too

Every change made via the CLI, REST API, or MCP Server is auto-committed to Git. If an automation script updates a credential, you can see when it happened and what changed. If the AI assistant creates a page, it shows up in the history.

This is your audit trail. You know exactly what happened to every page in your vault, whether the change came from the editor, the CLI, or an AI tool.

How It Works Technically

Claspt initializes a Git repository inside your vault directory. The .git folder contains the full history. Here is what happens on each save:

  • File saved. The .md file is written to disk with your changes.
  • Auto-commit. Claspt stages the changed file and creates a commit with a timestamp message.
  • Index updated. The tantivy search index is updated to reflect the new content.
  • Remote push (optional). If you have configured a Git remote (Pro), the commit is pushed automatically.

The entire process takes milliseconds. You do not notice it happening. There is no "Save and commit" button — saving is committing.

Free vs. Pro Versioning

The free tier includes:

  • Local Git auto-commit on every save
  • Full version history browsable in the app

Pro adds:

  • Visual diff viewer with side-by-side comparison
  • One-click revert to any previous version
  • Merge conflict viewer for sync conflicts
  • Push to remote Git repos for off-device backup

Even on the free tier, your history is preserved in Git. You can always access it via the command line if you know Git. The Pro features add the visual UI that makes history browsing accessible without terminal knowledge.

Your Safety Net

Version history is the feature you never think about until you desperately need it. A deleted paragraph, an overwritten credential, a page that looked different last week — with Claspt, recovering from any of these takes one click. No backups to manage. No "hope you saved a copy." Just Git, doing what Git does best.

Try Claspt Free

Free on desktop. Git versioning built in. Your work is never lost.

Download Free