gitwtfhub

wtf is claude-checkpoint-manager-ccm?

mqz0211/claude-checkpoint-manager-ccm — explained in plain English

Analysis updated 2026-05-18

5JavaScriptAudience · developerComplexity · 2/5Setup · easy

TL;DR

A CLI that snapshots your code and Claude Code session together as hidden git checkpoints you can roll back to.

Mindmap

mindmap
  root((Claude Checkpoint Manager))
    What it does
      Snapshots code and session
      Hidden git refs
      Safe rollback
    Tech stack
      JavaScript
      Node.js
      Git
    Use cases
      Undo a bad AI edit
      Preview a restore
      Skip real git history
    Audience
      Developers using Claude Code
      AI coding assistant users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Roll back both code and Claude Code session state after an AI edit goes wrong

REASON 2

Save frequent checkpoints during an AI coding session without polluting git log

REASON 3

Preview a restore with dry-run before actually rolling back files

REASON 4

Attach an exported AI conversation file to a checkpoint for reference

What's in the stack?

JavaScriptNode.jsGit

How it stacks up

mqz0211/claude-checkpoint-manager-ccm00kaku/wp-rest-playgroundaaddrick/ticketmill
Stars555
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyhardhard
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Beta software, requires Node.js 16+ and git on PATH, back up important work before relying on --prune restores.

Wtf does this do

Claude Checkpoint Manager, known by its command name ccm, is a command line tool that lets developers save and roll back both their code and the state of an AI coding assistant session together, specifically for people using Claude Code. The idea is that when an AI assistant makes a series of changes that go wrong, you can rewind your files and the assistant's session context back to an earlier known good point, without cluttering your project's real git history with a pile of experimental commits. It works by storing each checkpoint as a normal git commit, but hidden away on a special reference path that git's usual commands like git log and git status never look at, so your visible history stays clean while still benefiting from git's efficient storage, meaning unchanged files across checkpoints take up almost no extra disk space. Alongside your code, it also copies relevant session state files from the folders Claude Code stores its local data in, skipping anything that looks like it might contain a secret, password, or API key, and referencing rather than copying very large files. Using it involves running one setup command in a project, then saving a checkpoint with a short message whenever you reach a good point in your work. A status command shows a timeline of your checkpoints with file counts, sizes, and rough token estimates, and a restore command rolls your files and session state back to a chosen checkpoint. Restores automatically take a safety checkpoint of your current state first, so even a restore itself can be undone if needed, and there is a preview mode that shows what a restore would change without actually doing it. The project is installed by cloning its repository and running a couple of npm commands, and it requires Node.js and git to already be available on your computer. The author describes the project as still in beta, with the core commands implemented and tested but not yet used heavily in the real world, and recommends backing up anything important before relying on it.

Yoink these prompts

Prompt 1
Help me install ccm and run ccm init in my project to start using checkpoints
Prompt 2
Explain how ccm hides checkpoints from git log using custom refs
Prompt 3
Walk me through saving a checkpoint, then restoring it with the dry-run flag first
Prompt 4
Show me how ccm avoids capturing secrets or API keys when it saves session state

Frequently asked questions

wtf is claude-checkpoint-manager-ccm?

A CLI that snapshots your code and Claude Code session together as hidden git checkpoints you can roll back to.

What language is claude-checkpoint-manager-ccm written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Git.

How hard is claude-checkpoint-manager-ccm to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-checkpoint-manager-ccm for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.