v0.3.0

What's New in v0.3.0

• Project-Specific Snapshot Folders: Checkpoints are now organized in subdirectories matching the workspace project name (e.g. ~/.config/ckpt/snapshots/<project_name>/).
• Interactive Project Renaming: Detects if you renamed your local project folder and prompts you (using arrow keys) to migrate your checkpoint history to the new folder name.
• Restore Safety warnings: Prompts to confirm before restoring if uncommitted changes are present in your workspace, preventing accidental data loss.
• Deterministic Windows Restores: Re-applies diffs on the exact base commit hash using git checkout and --ignore-whitespace to solve line-ending carriage return/corrupt patch failures.
• CLI Version Tracking: View current package version with ckpt -v, ckpt --version, or directly in the CLI help text.
• Legacy Checkpoint Migration: Silently migrates older checkpoints directly under snapshots/ into a dedicated legacy/ directory to prevent clutter.

v0.2.0 - Premium Interactive Selection & OpenRouter Support

🚀 Major Feature Upgrades

• Interactive Restore Menu: Added a gorgeous interactive console list for selecting checkpoints with real-time arrow keys and dynamically wrapped terminal limits to prevent line wrapping and screen glitches.
• Interactive LLM Provider Setup: Added an arrow-key selection list for configuring Ollama, Google Gemini, or OpenRouter.
• OpenRouter Cloud Integration: Direct support for OpenRouter's API, enabling Llama 3 or any hosted LLM to generate high-density session summaries.
• Direct Mental Map Injection: Allow MCP-connected AI agents (like Claude Desktop, Windsurf, Cursor, or Antigravity) to inject pre-generated context summaries directly, bypassing external REST calls completely.
• Subprocess Hardening on Windows: Added system-level stdin isolation to git and icacls calls to prevent terminal hangs.
• Polished Formatting & Testing: Codebase is fully formatted to PEP 8 standards with Ruff, featuring a robust 59-test suite.

📦 Installation

Install globally using uv or pipx:

uv tool install ckpt-cli
# or
pipx install ckpt-cli

v0.1.1 - Bug Fix

fix

v0.1.0 - Initial Release

v0.1.0 - Initial Release

We are excited to announce the first official release of ckpt (ckpt-cli on PyPI) — a lightweight, privacy-first developer utility designed to prevent AI context bloat and session amnesia.

🚀 Key Features

• Zero-Friction Context Saving: Instantly snapshot your active Git branch, uncommitted diffs, and terminal command history.
• AI-Generated Mental Maps: Synthesize your current debugging state into a high-density, 150-word context payload using local (Ollama) or cloud (Gemini/Claude) LLMs.
• Universal MCP Server Support: Connect natively to Cursor, Claude Desktop, and Claude Code to let AI agents save and restore their own checkpoints autonomously.
• Interactive Terminal UI: Easily browse and restore past checkpoints using a beautiful, keyboard-driven dashboard.

📦 Quick Start

Run instantly without installation:

uvx --from ckpt-cli ckpt save "First checkpoint"