agentvc

Почему agentvc

Git создавался для людей, которые коммитят в человеческом темпе. AI-агенты меняют ваше рабочее пространство со скоростью машины: десятки файлов в минуту, неверные ходы, незаконченные рефакторинги, удаления, о которых вы не просили. К тому моменту, как вы это заметите, git stash вас уже не спасёт.

agentvc даёт каждой сессии агента машину времени. Он создаёт снимок всего рабочего пространства за миллисекунды, разветвляет параллельные попытки по веткам и мгновенно восстанавливает любое предыдущее состояние — с нулевой потерей данных по построению.

Related MCP server: statecli-mcp-server

Возможности

Почему не просто git?

agentvc не заменяет git для выкладки кода. Он находится под циклом агента: дешёвая, одноразовая, перематываемая история, которая никогда не засоряет ваш git log.

Требования

Node.js 20 или новее. Других зависимостей времени выполнения нет.

Установка

npm install -g agentvc

Или запустите без установки:

npx agentvc init

Быстрый старт

mkdir demo && cd demo
avc init                              # initialise .avc/

echo "v1" > app.txt
avc save -m "known good state"        # checkpoint everything

echo "v2" > app.txt                   # ...agent goes wrong...
avc status                            # see what changed
avc diff -p                           # see exactly which lines changed
avc rollback HEAD                     # instant undo — nothing lost

avc branch plan-b && avc switch plan-b   # fork a parallel attempt
avc save -m "trying redis instead"
avc timeline                          # every attempt, side by side

Дайте агенту машину времени

Зарегистрируйте встроенный MCP-сервер один раз — и ваш агент сможет самостоятельно создавать контрольные точки и восстанавливаться.

Claude Code

claude mcp add agentvc -- avc mcp

Cursor · Codex · любой MCP-клиент — добавьте в .mcp.json (или см. examples/mcp-config.json):

{
  "mcpServers": {
    "agentvc": { "command": "avc", "args": ["mcp"] }
  }
}

Задайте AVC_ROOT=/path/to/project, если сервер не должен использовать свою рабочую директорию.

Научите его, когда создавать контрольные точки

Добавьте это в ваш AGENTS.md / CLAUDE.md — это разница между просто удобным инструментом и настоящей страховочной сетью:

## Session checkpoints (agentvc)

- Before any risky operation (refactors, deletions, dependency upgrades,
  schema changes), call `avc_save` with a short message.
- After reaching a working state, call `avc_save` again.
- If an approach fails twice, call `avc_rollback` to the last good checkpoint
  and try a different plan — optionally on a new branch via `avc_branch`.
- Never leave more than ~15 minutes of work uncheckpointed.

MCP-инструменты

Справочник CLI

Рефы принимают HEAD, имя ветки, полный идентификатор контрольной точки или любой уникальный префикс идентификатора.

avc diff -p выводит стандартные unified-диффы (--- a/path, +++ b/path, @@ фрагменты), поэтому вывод можно напрямую передавать в patch -p1 или git apply. Бинарные файлы обозначаются как Binary files … differ; файлы более 2 МБ / 50 000 строк перечисляются без содержимого, а изменения, слишком большие для точного построчного диффа, показываются как замена файла целиком.

Использование в качестве библиотеки

import { AgentVCS, formatPatch } from "agentvc";

const avc = new AgentVCS(projectRoot);
await avc.ensureInit();

const cp = await avc.save({
  message: "before db migration",
  meta: { task: "upgrade-postgres", attempt: 2 },
});

const { clean, modified } = await avc.status();
if (!clean) console.log("agent touched:", modified);

await avc.branch("plan-b");
await avc.checkout("plan-b");

await avc.rollback(cp.id);   // instant, lossless

for (const p of await avc.diffPatch(cp.id, "work")) {
  console.log(formatPatch(p));   // unified diff per file, with hunks available on p.hunks
}

Полная типизация. Экспортируются AgentVCS, diffTrees, computePatch, formatPatch и все типы результатов.

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

Хранилище, адресуемое по содержимому, — хорошая идея git без его церемоний:

.avc/
├── objects/ab/c3ef…      blobs + trees, deduplicated by SHA-256
├── checkpoints/          parents, tree, message, structured meta
├── refs/heads/main       branch tips
└── index.json            id → summary, for fast prefix lookups

• Идентичное содержимое файлов хранится один раз во всех контрольных точках и ветках.

• Неизменённые файлы никогда не перезаписываются при восстановлении.

• Ваш существующий .gitignore учитывается; .git/ и node_modules/ пропускаются.

• Удалите .avc/ — и ваше рабочее пространство останется нетронутым.

[!IMPORTANT] Гарантия безопасности. Каждый rollback и switch, прежде чем тронуть хотя бы один файл, сохраняет ваши несохранённые изменения в автоматическую контрольную точку безопасности. Откат обратим. В agentvc нет пути выполнения, который мог бы потерять вашу работу.

Дорожная карта

• Построчные диффы в терминале (avc diff -p)

• Слияние веток (сейчас fast-forward, далее 3-way)

• Хуки автосохранения: по файловому наблюдателю или после каждого шага агента

• Координация нескольких агентов — два агента, один репозиторий, отдельные ветки

• Именованные вехи и теги сессий

• Python SDK с паритетом по MCP

• Опциональное шифрованное удалённое резервное копирование хранилища контрольных точек

Идеи и PR приветствуются — см. CONTRIBUTING.md.

Участие

git clone https://github.com/nintechio/agentvc.git
cd agentvc && npm install
npm run typecheck && npm test && npm run build

Баг-репорты, запросы функций и пул-реквесты приветствуются. Пожалуйста, прочитайте CONTRIBUTING.md и наш Кодекс поведения. Проблемы безопасности: см. SECURITY.md.

Лицензия

MIT © Nintech Ltd

Создано и сопровождается Nintech

Инженеры, которые его разрабатывают, сами же его и эксплуатируют.

Прикладной ИИ · отказоустойчивая разработка ПО · управляемый хостинг — Великобритания и ЕС

nintech.io · GitHub · X · YouTube · admin@nintech.io