## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://docs.entire.io/llms.txt)

Use this file to discover all available pages before exploring further.

---

Work with checkpoints captured by Entire.

```
entire checkpoint SUBCOMMAND
```

##  checkpoint list

List checkpoints on the current branch.

```
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.

```
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)                                                |

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

##  checkpoint search

Search checkpoints using semantic and keyword matching.

```
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.

`entire checkpoint rewind` is deprecated and will be removed in a future release.

```
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)          |

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.