/checkpoint_list Command

List all available checkpoints with filtering and search capabilities.

Usage

# List all checkpoints
/checkpoint_list

# List last 10 checkpoints
/checkpoint_list --limit 10

# Search by tag
/checkpoint_list --tag refactoring

# Filter by date range
/checkpoint_list --start "2026-01-01" --end "2026-01-31"

Arguments

Argument	Type	Required	Default	Description
--limit	number	No	All	Maximum number of checkpoints to return
--tag	string	No	All	Filter by checkpoint tag
--start	string	No	All	Filter checkpoints after this date (YYYY-MM-DD)
--end	string	No	All	Filter checkpoints before this date (YYYY-MM-DD)
--search	string	No	All	Search by name or description

Output Format

/checkpoint_list

# Output:
ID: 20260102-1430
Name: "Before refactoring auth module"
Created: 1/2/2026, 2:30:00 PM
Branch: feature/auth
Tags: refactoring, before-change
Modified Files: 3 files
Commit: abc1234
----------------------------------------
ID: 20260102-1500
Name: "Completed authentication refactoring"
Created: 1/2/2026, 5:00:00 PM
Branch: feature/auth
Tags: done, refactoring, after-change
Modified Files: 12 files
Commit: def5678
----------------------------------------
...

Checkpoint States

Status	Description
Valid	Checkpoint can be restored (clean git state)
Outdated	Git state no longer exists (checkpoint outdated)

Use Cases

List All Checkpoints

/checkpoint_list

# Shows all checkpoints in .aikit/checkpoints/

Filter by Tag

# List refactoring checkpoints
/checkpoint_list --tag refactoring

# List pre-change checkpoints
/checkpoint_list --tag before-change

Filter by Date

# Checkpoints in January 2026
/checkpoint_list --start "2026-01-01" --end "2026-01-31"

# Last week
/checkpoint_list --start "2026-01-27" --end "2026-02-02"

Search Checkpoints

# Search by name
/checkpoint_list --search "authentication"

# Search by description
/checkpoint_list --search "migration"

Checkpoint Metadata

Each checkpoint includes:

---
id: "20260102-1430"
name: "Before refactoring auth module"
created: "2026-01-02T14:30:00Z"
gitBranch: "feature/auth"
gitCommit: "abc1234def5678..."
modifiedFiles:
  - src/auth/login.tsx
  - src/auth/jwt.ts
  - src/auth/middleware.ts
tags:
  - refactoring
  - before-change
message: Before refactoring authentication module
---

Best Practices

Checkpoint Management

✅ DO:

• Create checkpoints before major changes
• Use descriptive names
• Add relevant tags
• Clean up old checkpoints
• Restore to verify checkpoint validity

❌ DON'T:

• Create checkpoints too frequently
• Use vague names without context
• Skip adding tags
• Leave outdated checkpoints forever
• Restore checkpoints without testing

Checkpoint Strategy

When to Create:

• Before database migrations
• Before major refactors
• Before API changes
• After significant features
• Before risky operations

Checkpoint Content:

• Always commit changes first
• Include all modified files
• Note git branch and commit
• Add meaningful description

Checkpoint Restoration

✅ DO:

• Verify git state after restore
• Test that code builds
• Run tests to ensure everything works
• Document if restore was successful

❌ DON'T:

• Assume checkpoint is perfect
• Skip verification after restore
• Restore onto wrong branch
• Leave conflicts unresolved

Related Commands

• /checkpoint_create - Create checkpoint
• /checkpoint_restore - Restore from checkpoint
• /branch - Manage branches
• /stash - Save temporary work

Related Documentation

• Checkpoint System - Checkpoint architecture
• Git Workflow - Git best practices
• Session Management - Cross-session tracking

Next Steps

• Create Checkpoint - Create a new checkpoint
• Restore Checkpoint - Restore from checkpoint