agentvcs

name	agentvcs
description	Version an evolving agent/app with agentvcs — commit code+goal+models+trace together, diff per dimension, rollback mistakes, and freeze (crystallize) a trusted solution into a deterministic recipe. Use when working in a repo that has a .agentvcs/ directory or an agent.json, or when the user asks to version, snapshot, branch, undo, or freeze an agent/fleet.

Versioning evolving agents with agentvcs

agentvcs is a multidimensional VCS: each commit captures code + goal + models + trace and a state (fluid = evolving, crystallized = frozen/deterministic). Use it to make your own iterative work inspectable, reversible, and freezable.

Always pass --json

Run every command with --json. Output is one JSON object: {"ok": true, ...} on success, {"ok": false, "error": {"code": "...", "message": "..."}} on failure. Branch on the code, never on the message. Codes: NOT_A_REPO, ALREADY_REPO, NO_COMMITS, NO_PARENT, BAD_REF, AMBIGUOUS_REF, BRANCH_EXISTS, ALREADY_CRYSTALLIZED.

If your shell cwd is not sticky, use -C

Pass -C <project-dir> (like git -C) to run against that repo from anywhere: agentvcs -C /path/to/proj commit -m "..." --json. init creates the dir if absent.

The non-code state lives in agent.json

{ "goal"   ...