DEV Community

Entire profile image Rizèl Scarlett
Rizèl Scarlett for Entire

Posted on

How to Enable Entire

#ai #agents #entire #programming

How to Enable Entire in Your Repository

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

Enable Entire with one command

From the root of your Git repository, run:

entire enable -y
Enter fullscreen mode Exit fullscreen mode

The -y flag accepts the default setup options, including enabling Entire for all supported coding agents.

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.

Where Entire stores checkpoint data

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

refs/entire/checkpoints/
Enter fullscreen mode Exit fullscreen mode

Entire also supports storing checkpoints together on a dedicated branch:

entire/checkpoints/v1
Enter fullscreen mode Exit fullscreen mode

Both approaches keep your session history 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
Enter fullscreen mode Exit fullscreen mode

Existing repositories using entire/checkpoints/v1 can continue using it, while new repositories use the refs-based approach by default.

Configure Entire interactively

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

entire enable
Enter fullscreen mode Exit fullscreen mode

Entire will guide you through the configuration process.

You can also select a checkpoint storage option explicitly:

entire enable --checkpoint-backend refs
Enter fullscreen mode Exit fullscreen mode

Or:

entire enable --checkpoint-backend branch
Enter fullscreen mode Exit fullscreen mode

Confirm that Entire is enabled

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

entire status
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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

For a complete walkthrough, visit our Quickstart. If you are working with sensitive repositories, review Entire’s security and privacy documentation.

Happy trails!

Top comments (0)