Fix demo GIF — use asciinema cast + agg instead of broken VHS output

Python script generates proper asciicast v2 format with ANSI colors
(green checkmarks, cyan project names, yellow indices, gray tags,
purple/red memory types). Dracula theme, 150 frames, 776KB.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: KD-K2N2

assets/cortex-demo.gif

@@ -0,0 +1,150 @@
+{"version": 2, "width": 82, "height": 26, "env": {"SHELL": "/bin/bash", "TERM": "xterm-256color"}}
+[0.8, "o", "\u001b[32m\u276f\u001b[0m "]
+[0.845, "o", "c"]
+[0.89, "o", "o"]
+[0.935, "o", "r"]
+[0.98, "o", "t"]
+[1.025, "o", "e"]
+[1.07, "o", "x"]
+[1.115, "o", " "]
+[1.16, "o", "i"]
+[1.205, "o", "n"]
+[1.25, "o", "i"]
+[1.295, "o", "t"]
+[1.595, "o", "\r\n"]
+[2.295, "o", "\r\n"]
+[2.445, "o", "  \u001b[32m\u2713\u001b[0m Cortex v1.0.0 installed\r\n"]
+[2.595, "o", "  \u001b[32m\u2713\u001b[0m Daemon started (PID 48291)\r\n"]
+[2.745, "o", "  \u001b[32m\u2713\u001b[0m MCP server registered with Claude Code\r\n"]
+[2.895, "o", "  \u001b[32m\u2713\u001b[0m Database created (~/.cortex/cortex.db)\r\n"]
+[2.995, "o", "\r\n"]
+[3.095, "o", "  Cortex is ready. Open Claude Code \u2014 it will remember.\r\n"]
+[3.195, "o", "\r\n"]
+[4.995, "o", "\u001b[32m\u276f\u001b[0m "]
+[5.04, "o", "c"]
+[5.085, "o", "o"]
+[5.13, "o", "r"]
+[5.175, "o", "t"]
+[5.22, "o", "e"]
+[5.265, "o", "x"]
+[5.31, "o", " "]
+[5.355, "o", "s"]
+[5.4, "o", "t"]
+[5.445, "o", "a"]
+[5.49, "o", "t"]
+[5.535, "o", "u"]
+[5.58, "o", "s"]
+[5.88, "o", "\r\n"]
+[6.48, "o", "\r\n"]
+[6.6, "o", "  Daemon:     \u001b[32mrunning\u001b[0m (PID 48291, uptime 3d 14h)\r\n"]
+[6.7, "o", "  MCP Server: localhost:7434 (5 tools)\r\n"]
+[6.8, "o", "  Dashboard:  localhost:7433\r\n"]
+[6.9, "o", "  Database:   ~/.cortex/cortex.db (2.1 MB)\r\n"]
+[7.0, "o", "\r\n"]
+[7.1, "o", "  Projects:\r\n"]
+[7.22, "o", "    \u001b[36mmy-saas-app\u001b[0m       89 memories \u001b[32m(active)\u001b[0m\r\n"]
+[7.32, "o", "    cortex            34 memories\r\n"]
+[7.42, "o", "    infra-scripts     12 memories\r\n"]
+[7.52, "o", "    Total:           135 memories across 3 projects\r\n"]
+[7.62, "o", "\r\n"]
+[9.42, "o", "\u001b[32m\u276f\u001b[0m "]
+[9.465, "o", "c"]
+[9.51, "o", "o"]
+[9.555, "o", "r"]
+[9.6, "o", "t"]
+[9.645, "o", "e"]
+[9.69, "o", "x"]
+[9.735, "o", " "]
+[9.78, "o", "s"]
+[9.825, "o", "h"]
+[9.87, "o", "o"]
+[9.915, "o", "w"]
+[9.96, "o", " "]
+[10.005, "o", "m"]
+[10.05, "o", "y"]
+[10.095, "o", "-"]
+[10.14, "o", "s"]
+[10.185, "o", "a"]
+[10.23, "o", "a"]
+[10.275, "o", "s"]
+[10.32, "o", "-"]
+[10.365, "o", "a"]
+[10.41, "o", "p"]
+[10.455, "o", "p"]
+[10.5, "o", " "]
+[10.545, "o", "-"]
+[10.59, "o", "-"]
+[10.635, "o", "t"]
+[10.68, "o", "y"]
+[10.725, "o", "p"]
+[10.77, "o", "e"]
+[10.815, "o", " "]
+[10.86, "o", "d"]
+[10.905, "o", "e"]
+[10.95, "o", "c"]
+[10.995, "o", "i"]
+[11.04, "o", "s"]
+[11.085, "o", "i"]
+[11.13, "o", "o"]
+[11.175, "o", "n"]
+[11.475, "o", "\r\n"]
+[12.075, "o", "\r\n"]
+[12.175, "o", "  \u001b[1m# Decision memories for my-saas-app\u001b[0m (4 of 23)\r\n"]
+[12.275, "o", "\r\n"]
+[12.455, "o", "  \u001b[33m[1]\u001b[0m importance:\u001b[36m9\u001b[0m  2025-03-18  \u001b[90m#database #orm\u001b[0m\r\n"]
+[12.535, "o", "      Using Drizzle ORM \u2014 better edge runtime support, no binary dep\r\n"]
+[12.635, "o", "\r\n"]
+[12.815, "o", "  \u001b[33m[2]\u001b[0m importance:\u001b[36m8\u001b[0m  2025-03-17  \u001b[90m#react #architecture\u001b[0m\r\n"]
+[12.895, "o", "      Server components by default, use client only for state/effects\r\n"]
+[12.995, "o", "\r\n"]
+[13.175, "o", "  \u001b[33m[3]\u001b[0m importance:\u001b[36m8\u001b[0m  2025-03-16  \u001b[90m#auth\u001b[0m\r\n"]
+[13.255, "o", "      Clerk for auth, Supabase for DB only \u2014 no Supabase auth/storage\r\n"]
+[13.355, "o", "\r\n"]
+[13.535, "o", "  \u001b[33m[4]\u001b[0m importance:\u001b[36m7\u001b[0m  2025-03-15  \u001b[90m#styling\u001b[0m\r\n"]
+[13.615, "o", "      Tailwind 4 + CVA for component variants, no CSS modules\r\n"]
+[13.715, "o", "\r\n"]
+[15.515, "o", "\u001b[32m\u276f\u001b[0m "]
+[15.56, "o", "c"]
+[15.605, "o", "o"]
+[15.65, "o", "r"]
+[15.695, "o", "t"]
+[15.74, "o", "e"]
+[15.785, "o", "x"]
+[15.83, "o", " "]
+[15.875, "o", "s"]
+[15.92, "o", "e"]
+[15.965, "o", "a"]
+[16.01, "o", "r"]
+[16.055, "o", "c"]
+[16.1, "o", "h"]
+[16.145, "o", " "]
+[16.19, "o", "\""]
+[16.235, "o", "w"]
+[16.28, "o", "e"]
+[16.325, "o", "b"]
+[16.37, "o", "s"]
+[16.415, "o", "o"]
+[16.46, "o", "c"]
+[16.505, "o", "k"]
+[16.55, "o", "e"]
+[16.595, "o", "t"]
+[16.64, "o", " "]
+[16.685, "o", "t"]
+[16.73, "o", "i"]
+[16.775, "o", "m"]
+[16.82, "o", "e"]
+[16.865, "o", "o"]
+[16.91, "o", "u"]
+[16.955, "o", "t"]
+[17.0, "o", "\""]
+[17.3, "o", "\r\n"]
+[17.9, "o", "\r\n"]
+[18.0, "o", "  Found \u001b[1m2 matches\u001b[0m across 1 project:\r\n"]
+[18.1, "o", "\r\n"]
+[18.25, "o", "  \u001b[36m[my-saas-app]\u001b[0m \u001b[35mthread\u001b[0m (importance:7)\r\n"]
+[18.33, "o", "    WebSocket drops after 100s \u2014 suspect Cloudflare proxy timeout\r\n"]
+[18.43, "o", "\r\n"]
+[18.58, "o", "  \u001b[36m[my-saas-app]\u001b[0m \u001b[31merror\u001b[0m (importance:6)\r\n"]
+[18.66, "o", "    Reconnection loop when server restarts during active WS session\r\n"]
+[18.76, "o", "\r\n"]
+[20.76, "o", "\u001b[32m\u276f\u001b[0m "]

demos/cortex-demo.cast

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# Mock cortex CLI for demo recording
+
+case "$1" in
+  init)
+    sleep 0.3
+    echo ""
+    echo "  ✓ Cortex v1.0.0 installed"
+    echo "  ✓ Daemon started (PID 48291)"
+    echo "  ✓ MCP server registered with Claude Code"
+    echo "  ✓ Database created (~/.cortex/cortex.db)"
+    echo ""
+    echo "  Cortex is ready. Open Claude Code — it will remember."
+    echo ""
+    ;;
+  status)
+    sleep 0.3
+    echo ""
+    echo "  Daemon:     running (PID 48291, uptime 3d 14h)"
+    echo "  MCP Server: localhost:7434 (5 tools)"
+    echo "  Dashboard:  localhost:7433"
+    echo "  Database:   ~/.cortex/cortex.db (2.1 MB)"
+    echo ""
+    echo "  Projects:"
+    echo "    my-saas-app       89 memories (active)"
+    echo "    cortex            34 memories"
+    echo "    infra-scripts     12 memories"
+    echo "    Total:           135 memories across 3 projects"
+    echo ""
+    ;;
+  show)
+    sleep 0.3
+    echo ""
+    echo "  # Decision memories for my-saas-app (showing 4 of 23)"
+    echo ""
+    echo "  [1] importance:9  2025-03-18  #database #orm"
+    echo "      Using Drizzle ORM — better edge runtime support, no binary dep"
+    echo ""
+    echo "  [2] importance:8  2025-03-17  #react #architecture"
+    echo "      Server components by default, use client only for state/effects"
+    echo ""
+    echo "  [3] importance:8  2025-03-16  #auth"
+    echo "      Clerk for auth, Supabase for DB only — no Supabase auth/storage"
+    echo ""
+    echo "  [4] importance:7  2025-03-15  #styling"
+    echo "      Tailwind 4 + CVA for component variants, no CSS modules"
+    echo ""
+    ;;
+  search)
+    sleep 0.3
+    echo ""
+    echo "  Found 2 matches across 1 project:"
+    echo ""
+    echo "  [my-saas-app] thread (importance:7)"
+    echo "    WebSocket drops after 100s — suspect Cloudflare proxy timeout"
+    echo ""
+    echo "  [my-saas-app] error (importance:6)"
+    echo "    Reconnection loop when server restarts during active WS session"
+    echo ""
+    ;;
+esac

demos/mock/cortex

@@ -0,0 +1,140 @@
+#!/usr/bin/env python3
+"""Generate an asciinema .cast file for the Cortex demo, then convert to GIF."""
+
+import json
+import os
+import subprocess
+import sys
+
+CAST_FILE = "demos/cortex-demo.cast"
+GIF_FILE = "assets/cortex-demo.gif"
+
+events = []
+t = 0.0
+
+def out(text, delay=0.0):
+    global t
+    t += delay
+    events.append([round(t, 4), "o", text])
+
+def line(text, delay=0.1):
+    out(text + "\r\n", delay)
+
+def type_text(text, char_delay=0.045):
+    for ch in text:
+        out(ch, char_delay)
+
+def prompt(delay=0.5):
+    out("\x1b[32m❯\x1b[0m ", delay)
+
+def enter(delay=0.3):
+    out("\r\n", delay)
+
+def pause(seconds):
+    global t
+    t += seconds
+
+# --- Scene 1: cortex init ---
+prompt(0.8)
+type_text("cortex init")
+enter(0.3)
+pause(0.6)
+
+line("")
+line("  \x1b[32m✓\x1b[0m Cortex v1.0.0 installed", 0.15)
+line("  \x1b[32m✓\x1b[0m Daemon started (PID 48291)", 0.15)
+line("  \x1b[32m✓\x1b[0m MCP server registered with Claude Code", 0.15)
+line("  \x1b[32m✓\x1b[0m Database created (~/.cortex/cortex.db)", 0.15)
+line("")
+line("  Cortex is ready. Open Claude Code \u2014 it will remember.", 0.1)
+line("")
+
+# --- Scene 2: cortex status ---
+prompt(1.8)
+type_text("cortex status")
+enter(0.3)
+pause(0.5)
+
+line("")
+line("  Daemon:     \x1b[32mrunning\x1b[0m (PID 48291, uptime 3d 14h)", 0.12)
+line("  MCP Server: localhost:7434 (5 tools)", 0.1)
+line("  Dashboard:  localhost:7433", 0.1)
+line("  Database:   ~/.cortex/cortex.db (2.1 MB)", 0.1)
+line("")
+line("  Projects:", 0.1)
+line("    \x1b[36mmy-saas-app\x1b[0m       89 memories \x1b[32m(active)\x1b[0m", 0.12)
+line("    cortex            34 memories", 0.1)
+line("    infra-scripts     12 memories", 0.1)
+line("    Total:           135 memories across 3 projects", 0.1)
+line("")
+
+# --- Scene 3: cortex show ---
+prompt(1.8)
+type_text("cortex show my-saas-app --type decision")
+enter(0.3)
+pause(0.5)
+
+line("")
+line("  \x1b[1m# Decision memories for my-saas-app\x1b[0m (4 of 23)", 0.1)
+line("")
+line("  \x1b[33m[1]\x1b[0m importance:\x1b[36m9\x1b[0m  2025-03-18  \x1b[90m#database #orm\x1b[0m", 0.18)
+line("      Using Drizzle ORM \u2014 better edge runtime support, no binary dep", 0.08)
+line("")
+line("  \x1b[33m[2]\x1b[0m importance:\x1b[36m8\x1b[0m  2025-03-17  \x1b[90m#react #architecture\x1b[0m", 0.18)
+line("      Server components by default, use client only for state/effects", 0.08)
+line("")
+line("  \x1b[33m[3]\x1b[0m importance:\x1b[36m8\x1b[0m  2025-03-16  \x1b[90m#auth\x1b[0m", 0.18)
+line("      Clerk for auth, Supabase for DB only \u2014 no Supabase auth/storage", 0.08)
+line("")
+line("  \x1b[33m[4]\x1b[0m importance:\x1b[36m7\x1b[0m  2025-03-15  \x1b[90m#styling\x1b[0m", 0.18)
+line("      Tailwind 4 + CVA for component variants, no CSS modules", 0.08)
+line("")
+
+# --- Scene 4: cortex search ---
+prompt(1.8)
+type_text('cortex search "websocket timeout"')
+enter(0.3)
+pause(0.5)
+
+line("")
+line("  Found \x1b[1m2 matches\x1b[0m across 1 project:", 0.1)
+line("")
+line("  \x1b[36m[my-saas-app]\x1b[0m \x1b[35mthread\x1b[0m (importance:7)", 0.15)
+line("    WebSocket drops after 100s \u2014 suspect Cloudflare proxy timeout", 0.08)
+line("")
+line("  \x1b[36m[my-saas-app]\x1b[0m \x1b[31merror\x1b[0m (importance:6)", 0.15)
+line("    Reconnection loop when server restarts during active WS session", 0.08)
+line("")
+
+prompt(2.0)
+pause(2.0)
+
+# --- Write cast file ---
+header = {
+    "version": 2,
+    "width": 82,
+    "height": 26,
+    "env": {"SHELL": "/bin/bash", "TERM": "xterm-256color"}
+}
+
+os.makedirs(os.path.dirname(CAST_FILE), exist_ok=True)
+with open(CAST_FILE, "w") as f:
+    f.write(json.dumps(header) + "\n")
+    for ev in events:
+        f.write(json.dumps(ev) + "\n")
+
+print(f"Cast file: {CAST_FILE} ({len(events)} events)")
+
+# --- Convert to GIF ---
+os.makedirs(os.path.dirname(GIF_FILE), exist_ok=True)
+result = subprocess.run(
+    ["agg", "--theme", "dracula", "--font-size", "14", CAST_FILE, GIF_FILE],
+    capture_output=True, text=True
+)
+
+if result.returncode != 0:
+    print(f"agg error: {result.stderr}")
+    sys.exit(1)
+
+size = os.path.getsize(GIF_FILE)
+print(f"GIF created: {GIF_FILE} ({size / 1024 / 1024:.1f} MB)")