Ccheckpoints

CCheckpoints

A checkpoint system for Claude Code CLI that automatically tracks your coding sessions. Inspired by Cursor IDE's checkpoint feature - see everything you've done with Claude Code CLI and navigate through your conversation history.

On npm: ccheckpoints

What is CCheckpoints?

CCheckpoints hooks into Claude Code CLI to automatically save checkpoints every time you interact with Claude Code CLI. It creates a timeline of your entire coding session that you can view in a beautiful web dashboard.

Quick Start

That's it! Running ccheckpoints (or ccp) will:
1. ✅ Auto-setup Claude Code hooks (if not already done)
2. ✅ Start the background server
3. ✅ Open the dashboard in your browser

How It Works

1. Automatic Tracking: Every time you send a message to Claude Code CLI, CCheckpoints saves it as a checkpoint
2. Background Server: Runs quietly at http://127.0.0.1:9271 to handle tracking
3. Web Dashboard: Beautiful interface to see all your checkpoints and sessions
4. SQLite Database: All data stored locally in %APPDATA%/CCheckpoints/

Commands

Just run it!

This does everything - sets up hooks if needed and opens the dashboard.

Manual setup (optional)

Only needed if you want to setup without opening the dashboard.

Show dashboard

Same as running just ccheckpoints - opens the dashboard (with auto-setup if needed).

Help

Verbose mode

See detailed logs of what's happening behind the scenes.

What Gets Tracked?

- Every message you send to Claude Code CLI (submit event)
- Session stops (when you exit Claude Code)
- Timestamps for everything
- Full conversation context

Screenshots

📊 Session Overview
Get a bird's-eye view of all your Claude Code CLI sessions. See when you started, how long you worked, and track your productivity patterns.

🎯 Checkpoint…