mqz0211/claude-checkpoint-manager-ccm

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.