cli

每一次 AI 编程，都是一段「失踪的记忆」

你用过 Claude Code、Cursor 或者其他 AI 编程工具吗？相信大多数开发者的答案是肯定的。但你有没有遇到过这种情况：三个月前 AI 帮你写了一段逻辑，当时运行得好好的，现在代码出了问题，你想回头看看「当时到底问了什么、它到底做了什么」，却发现——那段对话已经彻底消失了。

这就是 AI 编程时代的「记忆黑洞」问题。代码还在，但产生这段代码的完整思考过程——提示词、上下文、工具调用、文件修改——全都无影无踪。Git 能告诉你「What changed」，但它永远无法回答「Why this way」。

Entire CLI 正是为了解决这个问题而诞生的。

---

项目起源：当 AI 成为代码的主要贡献者

Entire 的诞生背景，折射出一个正在发生却少有人正视的产业趋势：AI 正在成为代码库的主要贡献者之一。据一些开发团队的内部统计，在引入 AI 编程工具后，AI 生成的代码在某些仓库中已经超过 50%。但与此同时，软件开发行业积累了几十年的工程实践——代码审查、追溯变更原因、审计合规——几乎全都建立在「人类编写代码」这一前提之上。

当 AI 成为主力开发者，传统的工程体系出现了断层。Git 记录了最终产物，但没有记录 AI 的推理过程。团队在代码审查时，只能看到最终 diff，无法理解 AI 为什么选择了这个方案。审计人员需要了解「是谁写的这段逻辑」，但 AI 的答案永远是「我建议这样做」。

Entire 的作者正是看到了这个痛点，决定打造一个将 AI 编程会话与 Git 工作流深度绑定的工具。

---

核心能力：把 AI 对话「钉」在 Git 历史上

Entire 的设计理念非常清晰：让每一次 AI 编程会话都能被记录、追溯和恢复。

会话捕获与会话快照

当你在项目中启用 Entire 后，它会在后台静默运行。AI agent 与你的每一次对话——包括完整的提示词、响应内容、工具调用、文件修改记录——都会被实时捕获。当你或 AI agent 执行一次 Git 提交时，Entire 会自动在 entire/checkpoints/v1 分支上创建一个检查点（Checkpoint），将完整的会话元数据与这次提交永久绑定。

这意味着什么？Git 的每一次提交，从此都附带了一份「幕后日志」——不只是改了什么代码，还包括为什么改、怎么改的、改的过程中遇到了什么问题。

时光倒流：Rewind 与 Resume

Entire 还提供了两项非常实用的操作：Rewind（回退）和 Resume（恢复）。

Rewind 功能允许你回到任意一个历史检查点，恢复当时的代码状态和会话上下文。如果你发现 AI 最近的修改方向出了问题，可以立即回退到之前的正确版本，重新开始对话。

Resume 功能则更强大：当你切换分支或者新开一个工作窗口时，可以随时恢复之前 AI 会话的完整上下文，让 AI 从上次停下的地方继续工作，而不需要重新解释项目背景。

多 Agent 支持

Entire 不绑定特定的 AI 工具。它目前支持的 agent 包括：

• Claude Code（官方集成）
• OpenAI Codex
• Google Gemini CLI
• Cursor Agent
• GitHub Copilot CLI
• Factory AI Droid
• Pi Agent

无论你的团队使用哪种 AI 编程工具，只要在项目中运行 entire enable --agent <name>，Entire 就能开始捕获会话。

---

技术实现：Git 原生的存储哲学

Entire 的一个核心设计决策是不依赖外部数据库，而是将所有会话数据存储在 Git 分支中。这一选择带来了几个显著优势：

数据主权归用户所有。 会话数据不经过任何第三方服务，直接存储在用户自己的仓库里。这对于重视数据隐私和合规要求的团队尤为重要。

天然享受 Git 的所有能力。 会话历史可以被推送、克隆、对比和恢复。你可以在不同机器间同步，也可以在不同分支上并行运行多个 AI 会话而互不干扰。

Zero-lock-in。 如果有一天你不再使用 Entire，删除 Git hooks 即可，完全不影响代码本身。数据以标准 Git 分支形式存在，任何 Git 客户端都能访问。

在实现层面，Entire 基于 go-git 库操作 Git 仓库，通过 Git hooks 机制（pre-commit、post-commit 等）拦截 agent 的行为并记录会话。CLI 命令使用 Cobra 框架构建，提供交互式 TUI 界面。

---

上手体验：两行命令，即刻启用

Entire 的安装和配置非常简洁：

# 一键安装
curl -fsSL https://entire.io/install.sh | bash

# 在项目中启用
cd your-project && entire enable

如果需要指定特定的 AI agent：

entire enable --agent claude-code

entire status 可以随时查看当前会话状态，entire checkpoint rewind 可以回退到任意历史版本，entire session resume <branch> 可以恢复之前分支上的会话。整个工具链的设计非常一致，没有陡峭的学习曲线。

---

隐私与安全：需要认真对待的注意事项

Entire 官方文档中明确列出了几项安全注意事项，用户在正式使用前需要了解：

会话数据会存储在 Git 分支上。 如果你的仓库是公开的，entire/checkpoints/v1 分支对所有人可见。这意味着你的 AI 对话内容——包括可能包含的项目内部逻辑、API 设计思路——将被公开。

自动脱敏是「尽力而为」而非绝对安全。 Entire 会尝试自动检测并脱敏 API keys、tokens 等敏感信息，但在复杂场景下可能存在遗漏。

临时 shadow 分支在会话结束前可能包含未脱敏数据。 这些临时分支不应被推送到远程仓库。

对于涉及商业机密或高合规要求的项目，建议将 checkpoint 数据推送到一个独立的私有仓库，并仔细评估脱敏策略是否满足要求。

---

行业意义：AI 编程时代的版本控制 2.0

Entire 出现在 2025-2026 年 AI 编程工具大规模普及的背景下，其意义不仅是一个工具，更代表了一种新兴的工程实践理念：Agent-aware Version Control（Agent 可感知的版本控制）。

Thoughtworks 在其 Technology Radar 中将 Entire CLI 列为「评估」级别，指出它「为 AI 生成代码的可追溯性提供了一种自然契合 Git 的解决方案」，特别适合有合规或审计要求的使用场景。

随着 AI agent 在代码库中的参与度越来越高，传统的 PR 审查模式正在受到挑战——人类 Reviewer 很难在短时间内理解 AI 生成的数百行修改。Entire 通过将完整推理过程与代码变更绑定，让代码审查回归到「理解为什么」而非「检查对不对」。

这一方向的发展值得关注。随着更多团队引入 AI pair programming，Agent-native 开发工作流和可追溯性工具很可能会成为工程标准的一部分。

---

项目基本信息

项目	内容
仓库	entireio/cli
语言	Go
GitHub Stars	4,443
安装方式	Homebrew / install.sh / Scoop / Go install
部署难度	简单（纯 CLI，无需服务器）
Web UI	无（纯命令行工具）
许可证	MIT