v0.4.0

Portable agent environments, including history

agentenv v0.4.0 makes a rewindable AI-agent environment portable. You can now
move one snapshot—or the complete snapshot DAG, tags, history, and root
filesystems—to another agentenv instance without flattening it into a single
container image.

What is new

• Whole-environment bundles: export --format agentenv --all packages the
  complete DAG, tags, metadata, and every node rootfs; import restores it into
  an empty agentenv root.
• Portable snapshots: export one self-contained node and import it beneath
  an existing HEAD.
• Flat rootfs export: stream a node to docker import, or write a tarball
  for migration and image construction.
• Incremental init: init --sync folds host-side files added after the
  original seed into a new child node; --delete also mirrors removals.
• Content-based compression detection: gzip bundles are recognized from
  their bytes, including .agentenv.gz and extensionless files.
• A release gate for portability: CI now exercises sync/delete plus
  full-DAG, snapshot, and flat-rootfs export/import round trips.

Move a complete environment

agentenv export --format agentenv --all --gzip \
  -o environment.agentenv.gz

AGENTENV_ROOT=/fresh agentenv import environment.agentenv.gz

The receiving instance gets the original HEAD, branches, tags, history, and
node filesystems—not merely the latest directory tree.

Try the rollback demo

git clone https://github.com/css521/agentenv.git
cd agentenv
make demo

The demo runs as uid 1001 without --privileged. It mutates system files and
then verifies that a checkout restores the full managed rootfs.

Install

# Linux
go install github.com/css521/agentenv@v0.4.0

# Multi-arch container
docker pull ghcr.io/css521/agentenv:0.4.0

A ready-to-use Claude Code environment is also published as
ghcr.io/css521/rewindable-claude:0.4.0 for linux/amd64 and linux/arm64.

agentenv is filesystem-level rewind, not process-memory checkpointing, and its
rootless mode is not a security boundary for hostile code. See the
README for the
runtime model and limits, or the
full changelog
for implementation details.

v0.3.1

Changelog

• 05a35ad: ci: gofmt fixes for internal/api/http*.go (@css521)
• 632648c: docs: add GitHub Pages site with Chinese and English article (@css521)
• 5e8520e: fix: stop excluding GIF from Jekyll build (@css521)
• f5c8bf5: feat: zero-downtime auto-upgrade for the daemon (@css521)
• f96c96e: release: publish releases (non-draft) so "latest" resolves; date 0.3.1 (@css521)