SpecIt Demo Scripts

This folder contains a reproducible end-to-end demo flow for recording.

Scripts

• soup_to_nuts.sh - creates a demo project, runs specit init, exports files, validates, and diffs.
• auto_interview.expect - legacy external automation helper (not required for current --auto mode).

Quick Start

Manual interview (recommended first run):

./scripts/demo/soup_to_nuts.sh --specit-bin /Users/solvely/go/bin/specit

Auto interview typing (for recording):

./scripts/demo/soup_to_nuts.sh --auto --specit-bin /Users/solvely/go/bin/specit

--auto now uses specit init --demo, which runs the interview autoplay inside the TUI. The script injects a demo OPENAI_API_KEY only when one is not already set, so provider selection is available. It also sets SPECIT_OFFLINE_DEMO=1 by default so the interview runs fast/offline for reliable recordings.

Recording Tips

Record with macOS built-in recorder:

# 1) Start recording with Cmd+Shift+5 (selected region)
# 2) Run the demo script
./scripts/demo/soup_to_nuts.sh --auto --specit-bin /Users/solvely/go/bin/specit

Optional terminal transcript capture:

script -q /tmp/specit-demo-transcript.txt ./scripts/demo/soup_to_nuts.sh --auto --specit-bin /Users/solvely/go/bin/specit

Environment Knobs

• DEMO_TYPEWRITER=0 disables per-character command typing effect.
• DEMO_TYPE_DELAY_SECS=0.008 speeds up/slows down typing effect.
• DEMO_PAUSE_SECS=0.2 adjusts pause between demo steps.
• SPECIT_BIN=/path/to/specit sets the binary path.