terminal-demo-generator

# Terminal Demo Generator

Two approaches for terminal demo recordings:

| Method | Best For | Authenticity |
|--------|----------|--------------|
| **asciinema** | Real CC sessions, actual output | ⭐⭐⭐⭐⭐ |
| **VHS scripts** | Controlled demos, reproducible | ⭐⭐⭐ |

## Quick Start

### Real Session (Recommended)
```bash
# Record actual Claude Code session
asciinema rec --cols 120 --rows 35 -i 2 demo.cast

# Convert to MP4 via VHS
vhs << 'EOF'
Output demo.mp4
Set Width 1400
Set Height 800
Source demo.cast
EOF
```

### Scripted Demo
```bash
# Generate script via demo-producer
./skills/demo-producer/scripts/generate.sh skill verify

# Record with VHS
vhs orchestkit-demos/tapes/sim-verify.tape
```

## Recording Methods

### 1. Asciinema (Real Sessions)

Record actual Claude Code usage:

```bash
# Start recording
asciinema rec \
  --cols 120 \
  --rows 35 \
  --idle-time-limit 2 \
  session.cast

# Inside recording:
claude
> /verify
# ... real Claude output ...
> exit
```

See `references/asciinema-recording.md` for editing and conversion.

### 2. VHS Scripts (Controlled)

Pre-scripted terminal simulations:

```tape
Output demo.mp4
Set Shell "bash"
Set FontFamily "Menlo"
Set FontSize 16
Set Width 1400
Set Height 800
Set Theme "Dracula"
Set Framerate 30

Type "./demo-script.sh"
Enter
Sleep 15s
```

## Claude Code CLI Patterns

### Status Bar (CC 2.1.16+)
```
[Opus 4.5] ████████░░ 42% | ~/project git:(main) | ● 3m
✓ Bash ×3 | ✓ Read ×5 | ✓ Grep ×2 | ✓ Task ×∞
>> bypass permissions on (shift+Tab to cycle)
```

### Task Management
```
◆ TaskCreate #1 "Analyze codebase"
◆ TaskCreate #2 "Security scan"
◆ TaskCreate #3 "Generate report" blockedBy: #1, #2
◆ TaskUpdate: #1, #2 → in_progress (PARALLEL)
✓ Task #1 completed
✓ Task #2 completed
◆ Task #3 unblocked (2/2 resolved)
```

### Agent Spawning
```
⚡ Spawning 6 parallel agents via Task tool
  ▸ code-reviewer spawned
  ▸ security-auditor spawned
  ▸ test-generator spawned
```

## Color Codes

```bash
P="\033[35m"  # Purple - s