Add terminal walkthrough assets

README.md

@@ -2,6 +2,10 @@
 
 `pyro-mcp` runs commands inside ephemeral Firecracker microVMs using curated Linux environments such as `debian:12`.
 
+[![PyPI version](https://img.shields.io/pypi/v/pyro-mcp.svg)](https://pypi.org/project/pyro-mcp/)
+
+This is for coding agents, MCP clients, and developers who want isolated command execution in ephemeral microVMs.
+
 It exposes the same runtime in three public forms:
 
 - the `pyro` CLI
@@ -12,6 +16,7 @@ It exposes the same runtime in three public forms:
 
 - Install: [docs/install.md](docs/install.md)
 - First run transcript: [docs/first-run.md](docs/first-run.md)
+- Terminal walkthrough GIF: [docs/assets/first-run.gif](docs/assets/first-run.gif)
 - PyPI package: [pypi.org/project/pyro-mcp](https://pypi.org/project/pyro-mcp/)
 - Host requirements: [docs/host-requirements.md](docs/host-requirements.md)
 - Integration targets: [docs/integrations.md](docs/integrations.md)
@@ -63,6 +68,8 @@ uv run pyro doctor
 
 Use the package directly without a manual install:
 
+If you are running from a repo checkout instead, replace `uvx --from pyro-mcp pyro` with `uv run pyro`.
+
 ### 1. Check the host
 
 ```bash
@@ -127,7 +134,29 @@ uvx --from pyro-mcp pyro demo
 uvx --from pyro-mcp pyro demo --network
 ```
 
+`pyro demo` proves the one-shot create/start/exec/delete VM lifecycle works end to end.
+
+Example output:
+
+```json
+{
+  "cleanup": {
+    "deleted": true,
+    "reason": "post_exec_cleanup",
+    "vm_id": "..."
+  },
+  "command": "git --version",
+  "environment": "debian:12",
+  "execution_mode": "guest_vsock",
+  "exit_code": 0,
+  "stdout": "git version ...\n"
+}
+```
+
+When you are done evaluating and want to remove stale cached environments, run `pyro env prune`.
+
 If you prefer a fuller copy-pasteable transcript, see [docs/first-run.md](docs/first-run.md).
+The walkthrough GIF above was rendered from [docs/assets/first-run.tape](docs/assets/first-run.tape) using [scripts/render_tape.sh](scripts/render_tape.sh).
 
 ## Public Interfaces