checkpoint

Save a markdown checkpoint of a git repository's current state.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Save a snapshot of the current project state so you can return to it without reorientation time. The output is a markdown file with an immediate-action "Resume here" section at the top and supporting context below.

Core Features & Use Cases

  • Capture a complete project snapshot whenever you switch tasks, switch projects, or end your work day, so you can resume exactly where you left off.
  • Works across any git-enabled repository, recording the repository root, current branch, status, and recent commits to minimize reorientation.
  • Generates a portable checkpoint file that includes a ready-to-use "Resume here" section plus contextual state.

Quick Start

Trigger the checkpoint to save the current project state as a markdown checkpoint.

Frequently Asked Questions about checkpoint

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

FAQPage Schema
How do I save my git workflow context when switching tasks?

Trigger a checkpoint to save your current project state into a markdown file. It captures the repository root, branch, status, stashes, and recent commits, providing a "Resume here" section for instant context recovery.

What is the best way to resume work on a project after switching branches?

Use a generated checkpoint file to resume work. It features an immediate-action "Resume here" section at the top, followed by supporting git status and recent commit context to eliminate reorientation time.

Does this checkpoint tool work with any git-enabled repository?

Yes, it works across any git-enabled repository. It automatically records the repository root, current branch, status, and recent commits to minimize reorientation when returning to the project.

Where are project state checkpoints saved on my local machine?

Checkpoints are saved as markdown files locally under ~/dev_notes/checkpoints/<project-name>/. The file naming convention includes the timestamp and checkpoint type: YYYY-MM-DD_HHMMSS-<type>.md.

When should I generate a project context checkpoint?

Generate a checkpoint whenever you switch tasks, switch projects, or end your work session. This ensures you can return to the exact project state without reorientation time.