checkpoint

Checkpoint Command

Update the current session overview file with all findings, progress, and current status. This command helps maintain context across conversation resets and allows you to resume work seamlessly.

Step 1: Gather Current State

Run these commands to understand the current project state:

# Check git status
git status --short

# Show current branch
git branch --show-current

# Show uncommitted changes
git diff --stat

# Check for stashed changes
git stash list

# Show recent commits
git log --oneline -5

Step 2: Identify Session File Location

The session overview file is located at:

.claudex/sessions/{session-id}/session-overview.md

Determine the current session ID from the session context provided at conversation start.

Step 3: Update Session Overview

Update the session overview file with the following sections:

Session Summary

• Keep the original goal/purpose of the session
• Add any clarifications or scope changes that occurred

Current Focus

• Update with what you're currently working on
• If task is complete, describe what was just finished
• If blocked, describe the blocker clearly

Key Documents

• Add any new documentation files created
• Add any modified configuration files
• Include execution plans, architecture docs, test reports
• Use absolute paths for all file references

Progress Timeline

• Add a new timestamped entry describing:
  • What was accomplished
  • What decisions were made
  • What files were modified/created
  • Any blockers encountered
  • Next planned steps
• Format: - **YYYY-MM-DDTHH:MM:SSZ** - Description of progress

Status Field

Update the status to one of:

• In Progress - Active work ongoing
• Blocked - Waiting on external input or resolution
• Completed - All tasks finished
• Paused - Work temporarily suspended

Last Updated Timestamp

• Update the footer timestamp
• Include a brief description of the update type
• Format: *Last updated: YYYY-MM-DDTHH:MM:SSZ (Checkpoint: brief description)*