list · carlrannaberg — Claude Code command: what it does, how to install
list inspects git stash for Claude Code checkpoints, displaying their index, timestamp, branch, and description.
MIT ★ 763 updated 2026-03-31
.claude/commands/list.mdWhat list does
The command triggers git stash list and searches for records containing claude-checkpoint:. From every match, it extracts the stash index, the active Git branch, and the checkpoint note.
Timestamps are retrieved directly using git log -1 --format="%ai" stash@{n}. If no matching entries turn up, it prints an alert advising you to create one via /checkpoint [description].
Execution requires tool permissions for Bash(git stash:*). Any regular Git stash lacking the checkpoint prefix is filtered out.
What it helps with
- display project checkpoints saved during Claude Code sessions
- locate a specific stash index by date or description
- verify which Git branch a snapshot belongs to
Example prompts for the agent
- /list
- List all Claude Code checkpoints for this repo
- Show my saved git stash checkpoints with timestamps
How to install list
Manually: put the files in place
.claude/commands/list.mdCall it with /list. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/list.mdCall it with /prompts:list. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/list.prompt.mdManually: put the files in place
.gemini/commands/list.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about list
How to install list in Claude Code?
Save the command file to .claude/commands/list.md.
What does the list command do?
It reads git stash, filters entries tagged with claude-checkpoint:, and displays the index, timestamp, branch, and comment for each.
What happens if no checkpoints exist?
It reports that no checkpoints were found and recommends running /checkpoint [description].
Source text
list.md · MIT
---
description: List all Claude Code checkpoints with time and description
category: workflow
allowed-tools: Bash(git stash:*)
---
## List Claude Code checkpoints
Display all checkpoints created by Claude Code during this and previous sessions.
## Task
List all Claude Code checkpoints. Steps:
1. Run `git stash list` to get all stashes
2. Filter for lines containing "claude-checkpoint:" using grep or by parsing the output
3. For each matching stash line (format: `stash@{n}: On branch: message`):
- Extract the stash number from `stash@{n}`
- Extract the branch name after "On "
- Extract the checkpoint description after "claude-checkpoint: "
- Use `git log -1 --format="%ai" stash@{n}` to get the timestamp for each stash
4. Format and display as:
```
Claude Code Checkpoints:
[n] YYYY-MM-DD HH:MM:SS - Description (branch)
```
Where n is the stash index number
5. If `git stash list | grep "claude-checkpoint:"` returns nothing, display:
"No checkpoints found. Use /checkpoint [description] to create one."
Example: A stash line like `stash@{2}: On main: claude-checkpoint: before auth refactor`
Should display as: `[2] 2025-01-15 10:30:45 - before auth refactor (main)`
© carlrannaberg · MIT · carlrannaberg/claudekit
Similar slash commands
All slash commands for Git and GitHub →list by other authors comes first.