demo cleanup: drop obsolete scripted demos; the real Claude Code GIF is the hero

Removes the shell-scripted demos and headless recorders that the real Claude
Code self-rollback GIF (docs/claude-rewind.gif) now supersedes:
  examples/demo/ (killer-demo + self-rollback-demo + README)
  scripts/make-demo-gif.sh, scripts/make-claude-gif.sh,
  scripts/_claude-gif-inner.sh, scripts/rewindable-claude.sh
  docs/demo.{cast,gif}, docs/self-rollback.{cast,gif}
  Makefile 'demo' target

Updates README/CHANGELOG/docs/README/Makefile to point at the new GIF and the
TUI recorder (scripts/record-claude-tui.sh).

Author: css521

CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to this project are documented here. The format is based on
 [Keep a Changelog](https://keepachangelog.com/), and the project aims to follow
 [Semantic Versioning](https://semver.org/).
 
+## [Unreleased]
+
+### Added
+- New README hero GIF: real Claude Code, running inside `rewindable-claude`,
+  deletes its own binary then calls `agentenv__checkout` MCP tool to roll the
+  whole environment back — the binary is restored, the Claude session keeps
+  running. The one demo `git` can't reproduce.
+- `scripts/record-claude-tui.sh` + `scripts/fetch-recording-tools.sh` +
+  `scripts/Dockerfile.recorder`: apt-free recording pipeline (static
+  `asciinema` v3 + `agg` + a bundled monospace TTF; `agg --font-dir` covers
+  Claude TUI's box-drawing glyphs via a DejaVu fallback). Recorder image is a
+  pure `COPY` over `rewindable-claude` — seconds to build.
+
+### Removed
+- Obsolete shell-scripted demos and recorders that the real Claude Code GIF
+  supersedes: `examples/demo/` (killer-demo + self-rollback-demo + README),
+  `scripts/make-demo-gif.sh`, `scripts/make-claude-gif.sh`,
+  `scripts/_claude-gif-inner.sh`, `scripts/rewindable-claude.sh`,
+  `docs/demo.{cast,gif}`, `docs/self-rollback.{cast,gif}`,
+  Makefile `demo` target.
+
 ## [0.2.0] - 2026-06-16
 
 The "agent rolls back itself" release: an agent can now explore, undo, and

Makefile

@@ -8,15 +8,14 @@
 #   make vet               gofmt check + go vet
 #   make verify-rootless   end-to-end rootless E2E (Docker on macOS)
 #   make verify-btrfs      end-to-end privileged btrfs E2E (Docker, --privileged)
-#   make demo              record and re-render the README GIF
 #   make dev-shell         drop into a persistent dev container (fast inner loop)
 #   make clean             remove built artifacts
 
 GOOS_LINUX ?= linux
 GOARCH     ?= $(shell uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/;s/arm64/arm64/')
 GOPROXY    ?= $(shell go env GOPROXY)
 
-.PHONY: help build test vet verify-rootless verify-btrfs verify-supervise verify-mcp verify-rollback demo dev-shell dev-shell-stop clean
+.PHONY: help build test vet verify-rootless verify-btrfs verify-supervise verify-mcp verify-rollback dev-shell dev-shell-stop clean
 
 help:
 	@awk 'BEGIN{FS=":.*##"; printf "Targets:\n"} /^[a-zA-Z_-]+:.*##/ { printf "  %-22s %s\n", $$1, $$2 }' $(MAKEFILE_LIST)
@@ -67,9 +66,6 @@ verify-rollback: ## MCP-driven end-to-end rollback (asserts files actually rever
 	  --security-opt seccomp=unconfined --security-opt apparmor=unconfined \
 	  agentenv-rollback-smoke
 
-demo: ## record and re-render docs/demo.gif (the README GIF)
-	bash scripts/make-demo-gif.sh
-
 # --- Persistent dev container: fast inner loop on macOS -----------------------
 # `make dev-shell` starts (or reattaches to) a long-running container with the
 # source bind-mounted; rebuilds and verifies inside are seconds (no setup tax).

README.md

@@ -10,16 +10,16 @@ The environment versions itself automatically (zero agent intrusion), can roll
 back to **any node**, and can **branch** so an agent explores several approaches in
 parallel branches and keeps the winner.
 
-![agentenv demo: whole-environment rollback + branch exploration](./docs/demo.gif)
+![Claude Code deletes its own binary, then rolls the environment back via MCP and recovers it](./docs/claude-rewind.gif)
 
-> The agent deletes `/usr/local/bin/greet`, corrupts `/etc/motd`, and `rm -rf`s the
-> project — one `agentenv checkout` brings *all of it* back. Then three candidate
-> branches are explored from the same base; the one that passes is kept.
-> Recorded as **uid 1001, no `--privileged`** (the restricted-pod case).
+> Real Claude Code, running inside agentenv: it deletes `/usr/local/bin/claude`
+> (its own binary, system-wide — `git` cannot undo this), then calls the
+> `agentenv__checkout` MCP tool to roll the WHOLE environment back, and the
+> binary is restored. The Claude session itself keeps running throughout.
+> Reproducible from [`examples/claude-code/`](./examples/claude-code/); re-record
+> the GIF with [`scripts/record-claude-tui.sh`](./scripts/record-claude-tui.sh).
 
-See [`DESIGN.md`](./DESIGN.md) for the architecture, and
-[`examples/demo/`](./examples/demo/) for the demo (one command).
-Re-record the GIF with [`scripts/make-demo-gif.sh`](./scripts/make-demo-gif.sh).
+See [`DESIGN.md`](./DESIGN.md) for the architecture.
 
 ## Install
 
@@ -234,7 +234,6 @@ The core E2E suite (auto-capture, rollback, branch tournament) is in
 make verify-rootless     # rootless E2E: uid 1001, no --privileged
 make verify-supervise    # supervise + out-of-band ctl rollback
 make verify-btrfs        # privileged btrfs path (-tags btrfs)
-bash examples/demo/killer-demo.sh   # narrated branch-exploration demo
 ```
 
 The MCP path has its own dedicated harness under `verify/docker/`:
@@ -280,9 +279,10 @@ internal/image           seed-from-dir / extract-tarball, portable
 internal/watch           inotify recursive watcher
 internal/btrfs           btrfs SDK wrapper (cgo, -tags btrfs only)
 scripts/                 verify-rootless.sh, verify.sh, verify-supervise.sh,
-                          make-demo-gif.sh, agentenv-entrypoint.sh
+                          agentenv-entrypoint.sh; record-claude-tui.sh +
+                          fetch-recording-tools.sh + Dockerfile.recorder (GIF tooling)
 verify/docker/           mcp-smoke.sh, rollback-smoke.sh, claude-shell-*
-examples/                demo/, k8s/, branch_explore.py, goclient/, Client.java
+examples/                claude-code/, k8s/, branch_explore.py, goclient/, Client.java
 ```
 
 ## Developing on macOS / Windows
@@ -309,7 +309,6 @@ make vet               # gofmt check + go vet
 make verify-rootless   # full E2E: rootless / uid 1001 / no --privileged
 make verify-btrfs      # full E2E: privileged btrfs path (-tags btrfs)
 make verify-supervise  # supervise + ctl rollback end-to-end
-make demo              # re-record + re-render docs/demo.gif
 make dev-shell         # drop into a persistent Linux dev container (fast iteration)
 ```
 

docs/README.md

@@ -1,16 +1,23 @@
 # docs/
 
-Shareable assets — these are reproducible from the source:
+Shareable assets:
 
-- `demo.cast` — asciinema recording of `examples/demo/killer-demo.sh`
-- `demo.gif`  — same cast rendered to GIF (embedded at the top of the main README)
+- `claude-rewind.cast` — asciinema recording of a real Claude Code session
+  (running inside the `rewindable-claude` image) deleting its own binary,
+  then calling the `agentenv__checkout` MCP tool to roll the WHOLE environment
+  back, and the binary returns.
+- `claude-rewind.gif` — same cast rendered to GIF, embedded at the top of the
+  main README.
 
-To re-record both, run:
+Recording requires a real terminal (the interactive Claude Code TUI does not
+render without a TTY). To re-record:
 
 ```sh
-bash scripts/make-demo-gif.sh
+bash scripts/fetch-recording-tools.sh                                    # one-time
+docker build --platform=linux/$(uname -m) -f scripts/Dockerfile.recorder \
+  -t rewindable-claude-rec scripts/                                      # one-time
+ANTHROPIC_API_KEY=... [ANTHROPIC_BASE_URL=...] [ANTHROPIC_MODEL=...] \
+  bash scripts/record-claude-tui.sh                                      # each time
 ```
 
-The script does everything inside Docker (installs asciinema + downloads agg,
-builds agentenv, runs the demo as **uid 1001 with no `--privileged`** to mirror a
-restricted Kubernetes pod, then renders the cast to a GIF).
+See `scripts/record-claude-tui.sh` for the prompt suggestions.