AI 编码时代的飞行记录仪
Entire 是由 GitHub 前任 CEO 创办的 AI 开发观测与协同工具。它能够无感记录 AI 代理(如 Claude Code, Gemini CLI, Cursor)的完整交互上下文,帮团队归档会话记录、回滚错误代码,并实现多端会话交接,是 AI 时代的核心软件工程基础设施。
工作原理 & 影子分支机制
安装教程
brew tap entireio/tap
brew install entireio/tap/entire
curl -fsSL https://entire.io/install.sh | bash
go install github.com/entireio/cli/cmd/entire@latest
核心命令速查板
启用仓库的 AI 观测与归档
在当前项目根目录下运行。初始化 Entire 钩子,并在本地 `.git/hooks` 下注册触发动作。
交互式回退到安全的 Checkpoint
AI 代理改崩代码后的超级“后悔药”,能够快速还原工作目录状态。
entire rewind --list: 列出所有可退回的会话节点entire rewind --to <sha>: 强制切回到某个特定提交entire rewind --logs-only: 只回退会话 transcript 记录,不污染物理代码还原指定提交背后的 AI 推理细节
向其他人解释或自己审阅“这段代码是怎么出来的”。
entire explain <commit-sha>: 查看该提交的 Prompts 与 AI 工具调用链恢复另一台设备或历史分支的 AI 记忆
把开发任务无缝流转或继续以前的任务。
entire resume <branch-name>: 切换分支并自动唤醒最后会话查看当前绑定的会话与监控状态
检测本地是否有活跃的 AI 对话引擎与配置信息。
--detailed 诊断 hook 的配置和异常环境问题记忆闪卡 (测试你的掌握情况)
点击卡片可实现 3D 翻转,检查自己是否真正记住了 Entire 的核心机制。
Q: Entire 为什么能做到不让大量的 AI 会话聊天记录污染我们干净的 Git 提交历史?
A: 利用隐藏的影子分支
因为它使用了“影子分支”架构。所有的完整会话 Transcript 和推理数据都被自动推送到 entire/checkpoints/v1 隔离分支上,您的主分支 Commit Message 底部仅附带一个非常轻量的追踪 ID (Trailer)。
Q: 如果在使用 Claude Code 开发时 AI 陷入逻辑闭环并写坏了项目,该如何使用 Entire 抢救?
A: 运行 entire rewind
直接在终端运行 entire rewind。它会打开一个交互式的命令行终端列表,展示所有历史 Checkpoints。你可以通过上下键挑选并回滚,免去了手动使用 git stash 或繁琐回滚的痛苦。
Q: 怎么在多人之间实现 AI Session 的同步和记忆还原接力?
A: 使用 entire resume 命令
在另一台电脑拉取代码后运行 entire resume <branch-name>,Entire 会自动检测关联的隐藏影子分支,同步最新 Session 记忆,并引导您启动接力运行指令(例如继续唤醒 Claude)。
最佳实践
与 Claude Code 的配合
在使用 claude-code 时,AI Agent 的注意力很容易随着对话拉长而“腐败跑偏”,甚至产生有害代码或进入死循环。借助 Entire CLI 做底座,你可以大胆地尝试高侵入性的重构指令。
entire status 为 Activeentire rewind 重开,防止坏上下文被带入下一次生成无感自动捕获机制
将 Entire 纳入您或者您团队开发工作流的全局标准。这可以很好地规避“沉淀靠人主动做,但大家常嫌麻烦不做”的问题。所有的解释和还原逻辑全部托管给 shadow branch 跑在幕后。
entire enable 开启自动化覆盖