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!