# How to Enable Entire

> Source: <https://dev.to/entire/how-to-enable-entire-4h9l>
> Published: 2026-08-14 22:17:46+00:00

[Entire](https://entire.io/) captures the context behind AI-assisted code changes and connects it to your Git history.

It preserves details such as prompts, tool calls, file changes, and session transcripts as [checkpoints](https://docs.entire.io/overview). A checkpoint is a versioned record of the work completed during an agent session, linked to the Git commit that resulted from it.

Here’s how to enable Entire and prepare your repository for its first checkpoint.

From the root of your Git repository, run:

```
entire enable -y
```

The `-y`

flag accepts the default setup options, including enabling Entire for all [supported coding agents](https://docs.entire.io/agents/overview).

Entire installs the necessary hooks and creates its project configuration. These hooks capture the context from your agent sessions and connect it to your commits.

New setups use Git refs by default, storing each checkpoint independently under:

```
refs/entire/checkpoints/
```

Entire also supports storing checkpoints together on a dedicated branch:

```
entire/checkpoints/v1
```

Both approaches keep your [session history](https://docs.entire.io/glossary) separate from your working branch, so transcripts and checkpoint metadata do not clutter your code commits.

To select the branch-based option explicitly, run:

```
entire enable -y --checkpoint-backend branch
```

Existing repositories using `entire/checkpoints/v1`

can continue using it, while new repositories use the refs-based approach by default.

If you want to review the setup options and choose which agents to connect, run:

```
entire enable
```

Entire will guide you through the configuration process.

You can also select a checkpoint storage option explicitly:

```
entire enable --checkpoint-backend refs
```

Or:

```
entire enable --checkpoint-backend branch
```

Once setup is complete, check the repository’s status:

```
entire status
```

You’ll see which agents are connected, where checkpoints will be synchronized, and whether any agent sessions are active.

After you work with an agent and create a Git commit, you can view the resulting checkpoints with:

```
entire checkpoint list
```

Your repository is now ready to capture the context behind your agent-assisted work.

For a complete walkthrough, visit our [Quickstart](https://docs.entire.io/quickstart). If you are working with sensitive repositories, review Entire’s [security and privacy documentation](https://docs.entire.io/security).

Happy trails!
