# deprecate 'entire checkpoint rewind' ahead of removal

`1e9b4a7`→[main](/content/gh/entireio/cli/commits/main/index.html)·

computermode·1mo ago·8 files·+66 added/-20 removed

The command stays functional but prints a removal notice to stderr and
is excluded from help and completion (cobra hides deprecated commands).
The hidden top-level 'rewind' shortcut now carries the same removal
deprecation instead of a hideAsAlias hint pointing at the equally
deprecated canonical form, registered like the existing 'reset'
precedent.

Test helpers that parse 'rewind --list' JSON (integration TestEnv and
the e2e entire package) now capture stdout separately so the stderr
notice doesn't corrupt the JSON.

## Sessions

f32f963571e7View transcript

### Changes

8

- MCLAUDE.md+8/-5
- MREADME.md+5/-3
- cmd/entire/cli
  
  - Mcheckpoint_group.go+2/-4
  - integration_test
  
    - Mtestenv.go+7/-3
  
  - Mrewind.go+3/-2
  
  - Arewind_test.go+18
  
  - Mroot.go+3/-2
- e2e/entire
  
  - Mentire.go+20/-1

```
27 unmodified lines

...

### 3. Rewind to a Previous Checkpoint
### 3. Rewind to a Previous Checkpoint (deprecated)

> **Deprecated:** `entire checkpoint rewind` will be removed in a future release.

If you want to undo some changes and go back to an earlier checkpoint:

```plaintext
| `entire disable` | Remove Entire hooks from repository                                                               |
| `entire doctor`  | Fix or clean up stuck sessions                                                                    |
| `entire enable`  | Enable Entire in your repository                                                                  |
| `entire checkpoint`        | List, explain, rewind, and search checkpoints                                           |
| `entire checkpoint`        | List, explain, and search checkpoints                                                   |
| `entire checkpoint explain` | Explain a session, commit, or checkpoint                                               |
| `entire checkpoint rewind` | Rewind to a previous checkpoint                                                         |
| `entire checkpoint rewind` | Rewind to a previous checkpoint (deprecated, will be removed in a future release)       |
| `entire login`   | Authenticate the CLI with Entire device auth                                                      |
| `entire session` | View and manage agent sessions tracked by Entire                                                  |
| `entire session resume`    | Switch to a branch, restore latest checkpointed session metadata, and show command(s) |
```

### Command Documentation

// newCheckpointGroupCmd builds the `entire checkpoint` parent command and
// registers list/explain/rewind/search as children.
// registers list/explain/search as children, plus the deprecated rewind.
func newCheckpointGroupCmd() *cobra.Command {
	cmd := &cobra.Command{
		Use:     "checkpoint",
		Aliases: []string{"cp", "checkpoints"},
		Short:   "Inspect, rewind, and search checkpoints",
		Long: `Operations on checkpoints — the persistent records of agent work tied to commits.

Commands:
list     List checkpoints on the current branch
explain  Explain a checkpoint, commit, or session
rewind   Browse and rewind to a checkpoint
search   Search checkpoints (semantic + keyword)

Examples:
entire checkpoint list
entire checkpoint explain <id|sha>
entire checkpoint rewind --to <id>
entire checkpoint search "fix login",`,
	}
}

```