# Entire CLI — Record AI Sessions in Git

> CLI that hooks into Git to capture AI agent sessions alongside commits. Index, rewind, and resume per branch without polluting commit history.

## Install

Copy the content below into your project:

## Quick Use

```bash
# Install (macOS/Linux) via Homebrew
brew tap entireio/tap
brew install --cask entire

# Enable in a repo
cd your-repo && entire enable

# Check status / rewind
entire status
entire checkpoint rewind
```

## Intro

Entire CLI is a Git-native way to capture and replay AI coding sessions: your code commits stay clean, while agent session metadata lives on its own branch.

**Best for:** Teams doing AI-assisted coding who need auditable sessions and easy rollback

**Works with:** Git repos; integrates with agent CLIs and standard remotes

**Setup time:** 5–15 minutes

### Key facts (verified)

- README shows multiple install paths: Homebrew, install.sh, Scoop, and Go install.
- Sessions are stored on a dedicated `entire/checkpoints/v1` branch (per README).
- GitHub: 4,284 stars · 333 forks; pushed 2026-05-13 (GitHub API verified).

## Main

### Use it as “agent flight recorder”

If your team is doing AI-assisted changes, you want two things at once:

- **Clean commits** (so `git log` stays readable)
- **Durable provenance** (so you can answer “why did we change this?” later)

Entire sits in the middle: it tracks sessions as metadata and creates checkpoints when commits happen, so you can rewind to a known-good state without rewriting history.

### README excerpt (verbatim)

# Entire CLI

Entire hooks into your Git workflow to capture AI agent sessions as you work. Sessions are indexed alongside commits, creating a searchable record of how code was written in your repo.

With Entire, you can:

- **Understand why code changed** — see the full prompt/response transcript and files touched
- **Recover instantly** — rewind to a known-good checkpoint when an agent goes sideways and resume seamlessly
- **Keep Git history clean** — preserve agent context on a separate branch
- **Onboard faster** — show the path from prompt → change → commit
- **Maintain traceability** — support audit and compliance requirements when needed

## Why Entire

- **Understand why code changed, not just what** — Transcripts, prompts, files touched, token usage, tool calls, and more are captured alongside every commit.
- **Rewind and resume from any checkpoint** — Go back to any previous agent session and pick up exactly where you or a coworker left off.
- **Full context preserved and searchable** — A versioned record of every AI interaction tied to your git history, with nothing lost.
- **Zero context switching** — Git-native, two-step setup, works with Claude Code, Codex, Gemini, and more.

## Table of Contents

- [Why Entire](#why-entire)
- [Quick Start](#quick-start)
- [Typical Workflow](#typical-workflow)
- [Key Concepts](#key-concepts)
  - [How It Works](#how-it-works)
  - [Strategy](#strategy)
- [Local Device Auth Testing](#local-device-auth-testing)
- [Commands Reference](#commands-reference)
- [Configuration](#configuration)
- [Security & Privacy](#security--privacy)
- [Troubleshooting](#troubleshooting)
- [Development](#development)
- [Getting Help](#getting-help)
- [License](#license)

## Requirements

- Git
- macOS, Linux or Windows
- [Supported agent](#agent-hook-configuration) installed and authenticated

## Quick Start

```bash
# Install stable via Homebrew
brew tap entireio/tap
brew install --cask entire

# Or install nightly via Homebrew
brew tap entireio/tap
brew install --cask entire@nightly

# Or install stable via install.sh
curl -fsSL https://entire.io/install.sh | bash

# Or install nightly via install.sh
curl -fsSL https://entire.io/install.sh | bash -s -- --channel nightly

# Or install stable via Scoop (Windows)
scoop bucket add entire https://github.com/entireio/scoop-bucket.git
scoop install entire/cli

# Or install via Go (development/manual setup)
go install github.com/entireio/cli/cmd/entire@latest

# Linux: Add Go binaries to PATH (add to ~/.zshrc or ~/.bashrc if not already configured)
export PATH="$HOME/go/bin:$PATH"

### FAQ

**Q: Does it change my normal commits?**
A: It keeps your code commits normal; session data is tracked separately (see README).

**Q: Where does the session data live?**
A: The README describes storing session metadata on a dedicated checkpoints branch.

**Q: What’s a good first workflow?**
A: Enable it in one repo, then try `checkpoint rewind` to understand the rollback model.

## Source & Thanks

> Source: https://github.com/entireio/cli
> License: MIT
> GitHub stars: 4,284 · forks: 333

---

<!-- ZH -->

## 快速使用

```bash
# 安装（macOS/Linux）Homebrew
brew tap entireio/tap
brew install --cask entire

# 在仓库里启用
cd your-repo && entire enable

# 查看状态 / 回滚到检查点
entire status
entire checkpoint rewind
```

## 简介

Entire CLI 用 Git 原生方式记录和回放 AI 编码会话：你的代码提交保持干净，而会话元数据保存到独立分支，便于审计与复盘。

**最适合：** 需要审计/复盘 AI 编码过程，并且希望随时回滚的团队

**适配：** Git 仓库；可与多种 agent CLI 与常规 remote 流程配合

**配置时间：** 5–15 分钟

### 关键事实（已验证）

- README 提供多种安装方式：Homebrew、install.sh、Scoop、Go install。
- 会话数据写入独立的 `entire/checkpoints/v1` 分支（README 描述）。
- GitHub：4,284 stars · 333 forks；最近更新 2026-05-13（GitHub API 验证）。

## 正文

### 把它当作“Agent 飞行记录仪”

AI 辅助开发往往需要同时满足两点：

- **提交历史要干净**（`git log` 依旧可读）
- **过程要可追溯**（以后能回答“当时为什么这么改”）

Entire 的思路是把会话当作元数据记录，并在发生提交时产生可回滚的检查点。你可以回到某个稳定状态而无需重写历史。

### README 原文节选（verbatim）

# Entire CLI

Entire hooks into your Git workflow to capture AI agent sessions as you work. Sessions are indexed alongside commits, creating a searchable record of how code was written in your repo.

With Entire, you can:

- **Understand why code changed** — see the full prompt/response transcript and files touched
- **Recover instantly** — rewind to a known-good checkpoint when an agent goes sideways and resume seamlessly
- **Keep Git history clean** — preserve agent context on a separate branch
- **Onboard faster** — show the path from prompt → change → commit
- **Maintain traceability** — support audit and compliance requirements when needed

## Why Entire

- **Understand why code changed, not just what** — Transcripts, prompts, files touched, token usage, tool calls, and more are captured alongside every commit.
- **Rewind and resume from any checkpoint** — Go back to any previous agent session and pick up exactly where you or a coworker left off.
- **Full context preserved and searchable** — A versioned record of every AI interaction tied to your git history, with nothing lost.
- **Zero context switching** — Git-native, two-step setup, works with Claude Code, Codex, Gemini, and more.

## Table of Contents

- [Why Entire](#why-entire)
- [Quick Start](#quick-start)
- [Typical Workflow](#typical-workflow)
- [Key Concepts](#key-concepts)
  - [How It Works](#how-it-works)
  - [Strategy](#strategy)
- [Local Device Auth Testing](#local-device-auth-testing)
- [Commands Reference](#commands-reference)
- [Configuration](#configuration)
- [Security & Privacy](#security--privacy)
- [Troubleshooting](#troubleshooting)
- [Development](#development)
- [Getting Help](#getting-help)
- [License](#license)

## Requirements

- Git
- macOS, Linux or Windows
- [Supported agent](#agent-hook-configuration) installed and authenticated

## Quick Start

```bash
# Install stable via Homebrew
brew tap entireio/tap
brew install --cask entire

# Or install nightly via Homebrew
brew tap entireio/tap
brew install --cask entire@nightly

# Or install stable via install.sh
curl -fsSL https://entire.io/install.sh | bash

# Or install nightly via install.sh
curl -fsSL https://entire.io/install.sh | bash -s -- --channel nightly

# Or install stable via Scoop (Windows)
scoop bucket add entire https://github.com/entireio/scoop-bucket.git
scoop install entire/cli

# Or install via Go (development/manual setup)
go install github.com/entireio/cli/cmd/entire@latest

# Linux: Add Go binaries to PATH (add to ~/.zshrc or ~/.bashrc if not already configured)
export PATH="$HOME/go/bin:$PATH"

### FAQ

**它会改我的正常提交吗？**
答：不会。你的工作分支提交保持正常；会话数据单独记录（以 README 为准）。

**会话数据存在哪里？**
答：README 描述会话元数据保存到独立的 checkpoints 分支。

**最推荐的入门玩法？**
答：先在一个仓库启用，然后用 `checkpoint rewind` 理解回滚模型。

## 来源与感谢

> Source: https://github.com/entireio/cli
> License: MIT
> GitHub stars: 4,284 · forks: 333


---
Source: https://tokrepo.com/en/workflows/entire-cli-record-ai-sessions-in-git
Author: Script Depot