Дмитрий Тамаров

Ai-инженер, разработчик

14 февраля, 2026

Entire CLI — что это и как использовать

Зачем это нужно

Git фиксирует что изменилось в коде, но не почему. Когда код пишет AI-агент (Claude Code, Gemini CLI), контекст теряется ещё быстрее: закрыл терминал — и вся сессия пропала. Через неделю непонятно, зачем агент переписал модуль, какие промпты использовались, какие варианты отвергли.

Entire решает эту проблему: он автоматически записывает сессии работы с AI-агентом и привязывает их к git-коммитам. Получается «чёрный ящик» разработки — полная история решений, доступная для поиска, шеринга и отката.

Проще говоря: Git записывает историю кода — что изменилось, когда, кем. Entire записывает историю разговоров с AI — что ты попросил, что агент ответил, какие файлы трогал, сколько токенов потратил. И связывает одно с другим: открываешь коммит — видишь не только diff, но и весь диалог, который к нему привёл.

Entire работает локально, не требует внешних сервисов. Данные остаются в вашем git-репозитории. Лицензия — MIT.

Что происходит под капотом

Каждый раз, когда вы делаете git commit во время сессии с AI-агентом, Entire автоматически:

Сохраняет полный транскрипт — все промпты и ответы агента
Фиксирует, какие файлы были изменены
Привязывает данные к коммиту через трейлер Entire-Checkpoint: ...
Пушит метаданные на ветку entire/checkpoints/v1

Дополнительных действий не требуется — всё работает через git-хуки в фоне.

Практическая польза

Откат ошибок — агент наломал дров? entire rewind вернёт файлы и весь контекст к предыдущему состоянию. Это не просто git checkout, а восстановление с полной сессией.
Память между сессиями — через entire explain можно вспомнить, что именно делалось и почему, не перечитывая файлы заново.
Аудит решений — через месяц забыли, почему что-то настроено именно так? Чекпоинт покажет всю цепочку рассуждений.

Чего Entire не делает

Он не запускает код, не анализирует качество, не управляет задачами. Это именно журнал — запись того, что происходило между вами и AI-агентом, привязанная к git-истории.

Что именно записывается

Каждая сессия сохраняет:

Транскрипт — все промпты и ответы агента
Изменения файлов — какие файлы были затронуты
Чекпоинты — точки сохранения для отката
Использование токенов — input/output, кеш, количество API-вызовов
Метаданные — временные метки, тип агента, конфигурация
Атрибуция кода — сколько строк написал агент, сколько человек

Если агент порождает подзадачи (например, Claude Code через инструмент Task), вложенные сессии тоже сохраняются.

Установка

macOS:

brew install entireio/tap/entire

Linux / WSL:

curl -fsSL https://entire.io/install.sh | bash

Из исходников (нужен Go):

go install github.com/entireio/cli/cmd/entire@latest

Проверка:

entire version

Настройка в проекте

Проект должен быть git-репозиторием. Включаем Entire:

entire enable

По умолчанию — стратегия manual-commit и агент claude-code. Для Gemini CLI:

entire enable --agent gemini

Настройки Entire локальны для каждого репозитория. В каждом новом проекте запускайте entire enable заново.

Как это работает

Сессии

Сессия — полный цикл взаимодействия с AI-агентом от запуска до завершения. Создаётся автоматически при старте Claude Code или другого поддерживаемого агента.

Чекпоинты

Чекпоинт — точка сохранения с 12-символьным hex-идентификатором (например, 8a513f56ed70). Два типа:

Временные — создаются на теневых ветках (entire/<sessionID>-<worktreeID>) во время активной сессии. Позволяют откатиться к любому моменту. Не пушатся в remote, автоматически очищаются.

Фиксированные — сохраняются на постоянной ветке entire/checkpoints/v1 при git-коммитах. Содержат полный снимок: код, метаданные, транскрипт. К коммиту добавляется трейлер:

feat: Add login form validation

Entire-Checkpoint: a3b2c4d5e6f7

Это создаёт двустороннюю связь: из коммита можно найти сессию, из сессии — коммит.

Структура хранения на ветке чекпоинтов

Данные хранятся в шардированной структуре (по первым двум символам ID):

entire/checkpoints/v1
├── 0b/
│   └── 45ffa1b752/
│       ├── metadata.json          ← метаданные чекпоинта
│       └── 0/                     ← папка сессии
│           ├── full.jsonl         ← полный транскрипт
│           ├── context.md         ← промпт в markdown
│           └── metadata.json      ← токены, атрибуция

Эта ветка содержит только метаданные (не код) — ваша основная git-история остаётся чистой.

Атрибуция кода

Entire считает, сколько строк написал агент, а сколько — человек. Результат добавляется трейлером к коммиту:

feat: Add user authentication

Entire-Checkpoint: a3b2c4d5e6f7
Entire-Attribution: 73% agent (146/200 lines)

Система делает снимок кода перед каждым запуском агента и сравнивает изменения в итоговом коммите с вкладом агента, учитывая промежуточные правки человека.

Отслеживание токенов

Для каждого чекпоинта Entire фиксирует:

Input и output токены
Токены кеша (создание и чтение)
Количество API-запросов

Это позволяет видеть реальную стоимость разработки и находить паттерны в использовании.

Две стратегии

manual-commit (рекомендуется)

Чекпоинты создаются только при git-коммитах. Git-история остаётся чистой — никаких лишних коммитов. Безопасно для любой ветки, включая main.

entire enable --strategy manual-commit

auto-commit

Чекпоинт создаётся после каждого ответа агента. Генерирует много мелких коммитов (можно сквошить потом). Использовать только на feature-ветках.

entire enable --strategy auto-commit

Основные команды

Команда	Что делает
`entire enable`	Активирует в текущем репо, устанавливает git-хуки
`entire status`	Показывает состояние (`Enabled (manual-commit)`)
`entire rewind`	Откат к предыдущему чекпоинту
`entire resume <branch>`	Переключиться на ветку и восстановить сессию
`entire explain`	AI-объяснение сессии или коммита
`entire doctor`	Починить зависшие сессии
`entire disable`	Отключить (код не трогает)

Типичный рабочий процесс

# 1. Включить Entire (один раз на репо)
entire enable

# 2. Запустить Claude Code и работать как обычно
claude

# 3. Делать коммиты внутри сессии
git add . && git commit -m "Add scoring module"
# → Entire создаёт фиксированный чекпоинт и добавляет трейлер

# 4. Завершить сессию (выйти из claude)
# → Entire финализирует данные сессии

# 5. Откатиться, если нужно
entire rewind

# 6. Посмотреть, что происходило
entire explain

Настройки (.entire/settings.json)

Автосаммари — генерирует AI-описание сессии при коммите:

{
  "strategy": "manual-commit",
  "enabled": true,
  "strategy_options": {
    "summarize": { "enabled": true }
  }
}

Поле "agent" в settings.json не поддерживается (v0.4.4). Агент задаётся только через флаг entire enable --agent.

Отключить автопуш чекпоинтов:

{
  "strategy_options": {
    "push_sessions": false
  }
}

Персональные настройки (не коммитятся) — .entire/settings.local.json:

{
  "log_level": "debug"
}

Отладка

# Проверить статус
entire status

# Включить debug-логи
ENTIRE_LOG_LEVEL=debug entire status

# Починить зависшие сессии
entire doctor

# Сбросить shadow-ветку
entire reset --force

Для чего это полезно

Аудит решений — через неделю забыли, почему изменили формулу скоринга? entire explain покажет полную сессию с промптами и рассуждениями агента
Откат ошибок агента — Claude Code наломал дров → entire rewind вернёт к рабочему состоянию
Стоимость разработки — трекинг токенов показывает, сколько реально стоила каждая фича
Кто написал код — атрибуция показывает вклад агента vs. человека в каждом коммите
Онбординг — показать коллеге цепочку «промпт → решение → изменение → коммит»
Работа на нескольких ветках — entire resume восстанавливает контекст при переключении
Код-ревью — ревьюер видит не только diff, но и почему код был написан именно так

Ограничения

Нужен git-репозиторий
macOS / Linux (Windows только через WSL)
Настройки локальны для каждого репо — глобальной конфигурации нет
Метаданные хранятся на отдельной ветке — при push она тоже отправляется (можно отключить через push_sessions: false)