entireio/cli

Entire is a new developer platform that hooks into your git workflow to capture AI agent sessions on every push, unifying your code with its context and reasoning.

agentsaiclaudedeveloperdeveloper-platformgemini

GAI 中文摘要

Entire 是一个专为开发者设计的 Git 工作流增强工具，通过集成 AI Agent 会话记录，将代码变更与 AI 的决策过程、Prompt 及上下文进行统一关联。该平台能够自动捕获并索引每一次 AI 交互，从而填补了传统 Git 记录中缺乏 AI 推理过程的空白。

能够完整记录并索引包括 Prompt、响应内容、文件变动及工具调用在内的所有 AI 会话数据。支持在代码出现偏差时快速回溯至之前的检查点，并无缝恢复开发状态。在保持主分支 Git 提交记录整洁的前提下，将所有 AI 上下文存储于独立的版本化分支中。支持对历史开发过程进行全局搜索，为代码变更提供可追溯的审计线索。通过 Git 原生的钩子机制实现无感知运行，兼容 Claude Code、Gemini CLI 及 Cursor 等主流 AI 开发工具。

适用于深度使用 AI Agent 进行辅助编码的软件开发团队与个人开发者，特别适合在需要高可追溯性、代码审计以及多开发者协作维护 AI 开发上下文的复杂项目中使用。

⭐

3.8k

Stars

🔱

273

Forks

👁

Watchers

📋

127

Issues

GoMIT创建于 2026/1/2更新于今天

在 GitHub 上查看访问主页

README

由 Gemini 翻译整理

Entire CLI

Entire 是一个新的开发者平台，它能嵌入你的 Git 工作流程，在每次推送代码时捕获 AI Agent 的会话，将你的代码与其上下文及逻辑推理进行整合。

Entire 会在你工作时自动嵌入 Git 工作流程并捕获 AI Agent 的会话。这些会话与提交记录建立索引，从而创建一个可搜索的记录，详细展示代码在仓库中是如何编写的。

使用 Entire，你可以：

理解代码变更背后的原因 — 查看完整的提示词/响应记录以及涉及的文件。
即时恢复 — 当 Agent 出错时，回退到已知的正常检查点（Checkpoint）并无缝恢复工作。
保持 Git 历史整洁 — 将 Agent 的上下文保存在独立的分支上。
加速上手 — 展示从提示词 → 代码变更 → 提交的完整路径。
保持可追溯性 — 在需要时支持审计和合规性要求。

为什么选择 Entire

理解“为什么”改动，而不仅是改了“什么” — 每次提交时都会同时捕获对话记录、提示词、修改文件、Token 使用量、工具调用等信息。
从任意检查点回退并恢复 — 返回到之前的任何 AI 会话，并从你或同事中断的地方继续工作。
完整上下文保存并可搜索 — 与你的 Git 历史记录绑定的 AI 交互版本化记录，确保信息不丢失。
零上下文切换 — Git 原生，两步设置，支持 Claude Code、Gemini 等多种工具。

环境要求

Git
macOS 或 Linux (Windows 用户请通过 WSL 使用)
已安装并完成认证的 Claude Code、Gemini CLI、OpenCode、Cursor、Factory AI Droid 或 GitHub Copilot CLI

快速开始

# 通过 Homebrew 安装
brew tap entireio/tap
brew install entireio/tap/entire

# 或通过 Go 安装
go install github.com/entireio/cli/cmd/entire@latest

# Linux: 将 Go 二进制目录添加到 PATH (如果尚未配置，请添加到 ~/.zshrc 或 ~/.bashrc)
export PATH="$HOME/go/bin:$PATH"

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

# 检查状态
entire status

典型工作流程

1. 在你的仓库中启用 Entire

entire enable

此操作会安装 Agent 和 Git Hook，以适配你的 AI Agent（Claude Code, Gemini CLI, OpenCode, Cursor, Factory AI Droid, 或 Copilot CLI）。系统会提示你选择要启用的 Agent。若要以非交互方式启用特定 Agent，请使用 entire enable --agent <name>（例如 entire enable --agent cursor）。

Hook 会在你工作时捕获会话数据。当你或 Agent 进行 Git 提交时，系统会创建检查点。你的代码提交保持干净，Entire 永远不会在你的当前分支上创建提交。所有会话元数据都存储在单独的 entire/checkpoints/v1 分支上。

2. 使用你的 AI Agent

像往常一样使用 Claude Code, Gemini CLI, OpenCode, Cursor, Factory AI Droid 或 Copilot CLI 即可。Entire 会在后台运行并追踪你的会话：

entire status  # 随时检查当前会话状态

3. 回退到之前的检查点

如果你想撤销一些更改并回到之前的检查点：

entire rewind

这会显示当前会话中所有可用的检查点。选择一个即可将代码恢复到那个确切的状态。

4. 恢复之前的会话

若要为某个分支恢复最近的检查点会话元数据：

entire resume

Entire 会检出该分支，恢复最新的已检查点会话元数据（一个或多个会话），并打印出继续工作的命令。

5. 禁用 Entire (可选)

entire disable

此操作将移除 Git Hook。你的代码和提交历史将保持原样，不受影响。

核心概念

会话 (Sessions)

会话代表与 AI Agent 的一次完整交互，从开始到结束。每个会话都会捕获所有的提示词、响应、修改过的文件以及时间戳。

会话 ID 格式: YYYY-MM-DD-<UUID> (例如：2026-01-08-abc123de-f456-7890-abcd-ef1234567890)

会话数据与你的代码提交分离开来，存储在 entire/checkpoints/v1 分支上。

检查点 (Checkpoints)

检查点是会话中的一个快照，你可以回退到该位置——即你工作过程中的一个“存档点”。

当你或 Agent 执行 Git 提交时，会自动创建检查点。检查点 ID 是 12 位的十六进制字符串 (例如：a3b2c4d5e6f7)。

工作原理

Your Branch                    entire/checkpoints/v1
     │                                  │
     ▼                                  │
[Base Commit]                           │
     │                                  │
     │  ┌─── Agent works ───┐           │
     │  │  St