> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.io/llms.txt
> Use this file to discover all available pages before exploring further.

# checkpoint

> List, explain, search, and rewind checkpoints.

Work with checkpoints captured by Entire.

```bash theme={null}
entire checkpoint SUBCOMMAND
```

## checkpoint list

List checkpoints on the current branch.

```bash theme={null}
entire checkpoint list [flags]
```

| Flag           | Description                                  |
| -------------- | -------------------------------------------- |
| `--no-pager`   | Disable pager output                         |
| `--session ID` | Filter checkpoints by session ID (or prefix) |

## checkpoint explain

Generate an AI-powered explanation of a session or commit.

```bash theme={null}
entire checkpoint explain [CHECKPOINT_ID | COMMIT_SHA] [flags]
```

| Flag                  | Description                                                           |
| --------------------- | --------------------------------------------------------------------- |
| `-c, --checkpoint ID` | Explain a specific checkpoint (ID or prefix)                          |
| `--commit SHA`        | Explain a specific commit (SHA or ref, "commit-ish")                  |
| `--force`             | Regenerate summary even if one already exists (requires `--generate`) |
| `--full`              | Show full parsed transcript (all prompts/responses)                   |
| `--generate`          | Generate an AI summary for the checkpoint                             |
| `--no-pager`          | Disable pager output                                                  |
| `--raw-transcript`    | Show raw transcript file (JSONL format)                               |
| `--search-all`        | Search all commits (no branch/depth limit, may be slow)               |
| `--session ID`        | Filter checkpoints by session ID (or prefix)                          |
| `-s, --short`         | Show summary only (omit prompts and files)                            |

<Note>
  The `--generate` flag requires the configured provider CLI, such as Claude CLI, to be installed and authenticated.
</Note>

## checkpoint search

Search checkpoints using semantic and keyword matching.

```bash theme={null}
entire checkpoint search [QUERY] [flags]
```

| Flag                | Description                                                   |
| ------------------- | ------------------------------------------------------------- |
| `--author NAME`     | Filter by author name                                         |
| `--branch NAME`     | Filter by branch name                                         |
| `--date PERIOD`     | Filter by time period (`week` or `month`)                     |
| `--json`            | Output as JSON                                                |
| `--limit N`         | Maximum number of results per page                            |
| `--page N`          | Page number, 1-based                                          |
| `--repo OWNER/REPO` | Filter by repository. Use `*` to search all accessible repos. |

## checkpoint rewind

Rewind to a previous checkpoint within the current session.

<Warning>
  `entire checkpoint rewind` is deprecated and will be removed in a future release.
</Warning>

```bash theme={null}
entire checkpoint rewind [flags]
```

| Flag          | Description                                                              |
| ------------- | ------------------------------------------------------------------------ |
| `--to COMMIT` | Rewind to specific commit ID (non-interactive)                           |
| `--list`      | List available rewind points (JSON output)                               |
| `--logs-only` | Only restore logs, don't modify working directory (for logs-only points) |
| `--reset`     | Reset branch to commit (destructive, for logs-only points)               |

<Warning>
  Rewinding discards changes made after the selected checkpoint. Make sure to commit any changes you want to keep before rewinding. The `--reset` flag is destructive and will reset your branch.
</Warning>