checkpoint-load

Display the most recent markdown checkpoint for the current project.

Updated May 22, 2025
One-click install
npx skills add https://github.com/curtjen/.gir --skill checkpoint-load
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint-load
Source: https://github.com/curtjen/.gir/tree/main/skills/checkpoint-load
Command: npx skills add https://github.com/curtjen/.gir --skill checkpoint-load

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Load the most recent checkpoint for the current project so you can pick up exactly where you left off.

Core Features & Use Cases

  • Detects the current project root via git rev-parse --show-toplevel (or uses the current directory name if not in a git repo).
  • Searches project-local <project-root>/.checkpoints/ and the global log at ~/dev_notes/checkpoints/<project>/ for the newest .md file by modification time.
  • Displays the contents with a clear "Resume here" lead and summarizes available older checkpoints.

Quick Start

Run /checkpoint to load the most recent checkpoint for your current project.

Frequently Asked Questions about checkpoint-load

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resume a coding project from where I left off?

To resume a coding project, you load the most recent checkpoint file which contains your previous progress notes. This Skill identifies the newest markdown checkpoint in your project or global log and displays its contents so you can pick up exactly where you stopped.

How does checkpoint loading find my project root directory?

Checkpoint loading determines your project root by running git rev-parse --show-toplevel to find the repository base. If you are not in a git repository, it falls back to using your current directory name to locate the relevant checkpoint files.

Where are project checkpoint files stored for resuming work?

Project checkpoints are stored as markdown files in two locations: the project-local directory at <root>/.checkpoints and the global log at ~/dev_notes/checkpoints/<project>/. The loader searches both and lists files by modification time.

Can I load checkpoints across different CLI coding tools like Claude Code and Codex?

Yes, checkpoint loading works across Claude Code and Codex environments. It searches the standard project-local and global checkpoint directories to find the newest markdown file, regardless of which CLI tool originally created the checkpoint.

What happens if there are older checkpoints available when I load the latest one?

When you load the latest checkpoint, the tool outputs a readable "Resume here" section with the file contents and also summarizes the older checkpoints that are available. This gives you immediate context alongside the history of your previous sessions.

Do I need to be in a git repository to use the checkpoint resume feature?

No, you do not need to be in a git repository to resume from a checkpoint. While the tool uses git rev-parse to find the project root automatically, it will fall back to the current directory name if git is not initialized, allowing you to load checkpoints anyway.