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

# clean

> Clean up Entire session data.

Clean up Entire session data.

```bash theme={null}
entire clean [flags]
```

| Flag           | Description                                             |
| -------------- | ------------------------------------------------------- |
| `-a, --all`    | Clean all Entire session data across the repository     |
| `--dry-run`    | Show what would be cleaned without actually deleting    |
| `-f, --force`  | Skip confirmation and override the active-session guard |
| `--session ID` | Clean a specific session by ID                          |

By default, `entire clean` removes session data for the current `HEAD` commit:

* Session state files for sessions based on the current commit
* The shadow branch for the current commit and worktree

Use `--session ID` to clean a single session. This removes the session state and deletes its shadow branch if no other session still needs it. File changes remain in your working directory.

Use `--all` to clean Entire session data across the repository:

* All session state files in `.git/entire-sessions/`
* All shadow branches
* Temporary files in `.entire/tmp/`

The permanent `entire/checkpoints/v1` branch is preserved.

```bash theme={null}
# Preview cleanup for the current HEAD
entire clean --dry-run

# Clean one session
entire clean --session 2026-02-02-test123 --force

# Clean all session data in the repository
entire clean --all --force
```

<Note>
  `entire reset` is deprecated. Use `entire clean` instead, or `entire clean --all` for repository-wide cleanup.
</Note>