Add VHS demo recording tape and assets

.pre-commit-config.yaml

@@ -6,6 +6,7 @@ repos:
       - id: end-of-file-fixer
       - id: check-yaml
       - id: check-added-large-files
+        args: ['--maxkb=1024']
 
   - repo: local
     hooks:

README.md

@@ -4,6 +4,8 @@
 
 Agentty is an **ADE (Agentic Development Environment) for structured, controllable AI-assisted software development**. It is itself developed with Agentty, built with Rust and [Ratatui](https://ratatui.rs), and designed around a deeply integrated workflow.
 
+![Agentty demo](docs/assets/demo/demo.gif)
+
 ## Installation
 
 ### Shell

docs/assets/AGENTS.md

@@ -4,4 +4,5 @@ Static assets used by documentation.
 
 ## Directory Index
 
+- [`demo/`](demo/) - VHS demo recording assets.
 - [`AGENTS.md`](AGENTS.md) - Context and instructions for AI agents.

docs/assets/demo/AGENTS.md

@@ -0,0 +1,34 @@
+# Demo
+
+Demo recording assets for Agentty. The demo GIF is manually recorded using
+[asciinema](https://asciinema.org/) and converted to GIF with
+[agg](https://github.com/asciinema/agg).
+
+## Recording
+
+```bash
+# Install tools (macOS)
+brew install asciinema agg
+
+# Start recording (use an isolated data directory)
+export AGENTTY_ROOT="/tmp/agentty-demo"
+rm -rf "$AGENTTY_ROOT"
+asciinema rec docs/assets/demo/demo.cast
+
+# In the recording session, launch agentty from a git repo and
+# demonstrate tab navigation, session creation, and agent interaction.
+# Press Ctrl-D or type `exit` to stop recording.
+
+# Convert to GIF
+agg --theme asciinema docs/assets/demo/demo.cast docs/assets/demo/demo.gif
+
+# Clean up the cast file (not committed)
+rm docs/assets/demo/demo.cast
+```
+
+## Directory Index
+
+- [`demo.gif`](demo.gif) - Manually recorded demo GIF.
+- [`AGENTS.md`](AGENTS.md) - Context and instructions for AI agents.
+- [`CLAUDE.md`](CLAUDE.md) - Symlink to AGENTS.md.
+- [`GEMINI.md`](GEMINI.md) - Symlink to AGENTS.md.

docs/assets/demo/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

docs/assets/demo/GEMINI.md

@@ -0,0 +1 @@
+AGENTS.md