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

Entire CLI – AI 增强的 Git 工作流

它是什么 – Entire 是一款命令行工具，可接入您的 Git 仓库，并记录您与 AI 编码助手（Claude、Codex、Cursor 等）的每一次交互。每个 AI 会话都作为检查点存储在特殊的 Git 引用中，并链接到创建它的提交。结果是可搜索、版本化的代码为何更改的转录，而不仅仅是更改了什么。

快速安装

平台	方法
macOS / Linux	`brew install --cask entireio/tap/entire`
Windows	PowerShell: `irm https://entire.com/install.ps1
任何操作系统（Go）	`go install github.com/entireio/cli/cmd/entire@latest`

您也可以通过相同的脚本获取特定版本或使用 nightly 频道。

核心概念

概念	含义
会话	一次完整的 AI 交互（所有提示、响应、涉及的文件）。
检查点	当您进行 Git 提交时保存的快照。存储为 Git 引用 `refs/entire/checkpoints/<shard>/<id>`，并通过 `Entire-Checkpoint` 尾部链接到提交。
检查点存储	元数据存储在 Git 对象中（不在分支历史中），因此您的代码历史保持整洁，而 AI 上下文被版本化并可随时获取。
代理钩子	Entire 安装 Git 钩子以捕获 AI 代理流量；您可以使用 `entire agent` 添加或删除代理。

典型工作流

启用在仓库中：entire enable（添加钩子，创建 .entire/settings.json）。
工作使用您常用的 AI 助手；Entire 在后台静默运行。
提交照常进行 – 钩子添加 Entire-Checkpoint 尾部并写入检查点引用。
恢复过去的会话：entire session resume <branch> 恢复检查点元数据，以便您从上次中断的地方继续。
搜索 / 审计：entire search、entire checkpoint explain 或 entire recap 查看转录、令牌使用、文件更改等。

主要命令（高级）

entire enable / disable – 为当前仓库启用或禁用 Entire。
entire status – 显示 Entire 是否激活以及当前会话信息。
entire agent – 添加/删除/列出支持的 AI 代理。
entire session … – 列出、检查、停止、附加或恢复 AI 会话。
entire checkpoint … – 列出、解释或搜索存储的检查点。
entire search – 跨检查点和提交进行语义/关键词搜索。
entire login / logout – 使用 Entire 控制平面进行身份验证（浏览器流程或用于无头 CI 的设备代码流程）。
entire doctor – 诊断和清理工具。

为什么使用 Entire？

可追溯性 – 每个提示、响应、文件编辑、令牌计数和工具调用都与引入更改的提交一起归档。有助于审计、合规或新团队成员入职。
干净的 Git 历史 – 您的分支中不会添加额外的提交；AI 上下文存储在单独的引用中。
恢复工作 – 从任何检查点跳回暂停的 AI 会话，即使在不同机器上也可以。
可搜索的知识库 – 使用 entire search 查找过去的 AI 建议，使仓库成为活文档来源。
适用于任何 Git 工作流 – 支持工作树、多个并发会话，并与现有 Git 钩子共存。

安全与隐私说明

令牌默认存储在操作系统密钥环中；无头环境可以使用文件支持的存储（ENTIRE_TOKEN_STORE=file）。
对于 CI，通过 ENTIRE_TOKEN 提供令牌以避免持久化凭据。
检查点数据存储在 Git 引用中，因此可以像任何其他 Git 对象一样推送、获取或剥离。

许可证

该仓库根据 LICENSE 文件中指定的条款发布（此处未复制）。

底线 – Entire 将 AI 辅助编码转变为版本控制工作流中的一等公民，为您提供永久、可搜索的代码为何更改的记录，同时保持 Git 历史整洁。

entireio/cli