════════════════════════════════════════════════════════════════════════
  DEMO SCRIPT
  Gnomad Desktop Assistant · docs/DEMO_SCRIPT.md
════════════════════════════════════════════════════════════════════════

DEMO SCRIPT — GNOMAD DESKTOP ASSISTANT
======================================

Duration: 5–7 minutes  
Audience: Portfolio review, interview, or investor technical screen  
Prerequisites: Installed alpha build, DeepSeek key or Ollama running

────────────────────────────────────────

SETUP (BEFORE YOU SHARE SCREEN)
-------------------------------

  1. Quit other assistants/tray clutter.
  2. Confirm Gnomad is in tray; window hidden.
  3. Pre-stage: one text file in Downloads, Ollama model pulled if local demo.
  4. Optional: add a short skills/demo-skill.md in knowledge (“Prefer concise answers”).
  5. Close sensitive windows; copy a harmless clipboard string (e.g. “Q2 roadmap draft”).

────────────────────────────────────────

ACT 1 — NATIVE PRESENCE (45 SEC)
--------------------------------

Say: “Gnomad is a native desktop assistant—not a browser tab. It lives in the menu bar / tray and respects OS conventions.”

  1. Press ⌘⇧Space (or Ctrl+Shift+Space) → panel appears.
  2. Point out context footer: active app, window title, clipboard.
  3. Click tray → show Pop out vs Windowed (brief).
  4. Close window → “It hides to tray; it doesn’t quit.”

────────────────────────────────────────

ACT 2 — ONBOARDING & MODELS (60 SEC)
------------------------------------

Say: “Users choose cloud or local inference; secrets go to the system keychain.”

  1. Open Settings (gear).
  2. Show API keys — configured, not visible.
  3. Toggle Provider: Cloud vs Local; change model dropdown.
  4. Mention .env for developers (optional one line).

────────────────────────────────────────

ACT 3 — CONVERSATION (90 SEC)
-----------------------------

Say: “Chat is grounded in what you’re working on.”

  1. New chat from sidebar.
  2. Click a suggestion chip or type:
   “Summarize what I’m working on based on my window and clipboard.”  
  3. Show assistant reply referencing context pills.
  4. Attach a small file → send → note attachment pill in thread.

────────────────────────────────────────

ACT 4 — AGENT & SAFETY (2 MIN) — HIGHLIGHT REEL
-----------------------------------------------

Say: “This is an agent that executes—not theater. Safety is explicit.”

  1. Safe shell:
   “Run echo Hello from Gnomad and show the output.”  
   → Point at shell block with stdout.

  2. Persistent cwd:
   “Run pwd then cd Desktop and pwd again.”  
   → Show cwd continuity in settings/shell block.

  3. Sudo Gate (careful):
   “Try sudo echo test” or use a flagged pattern.  
   → Deny first (“user stays in control”), then optionally approve on a safe test machine.

  4. Stop: Start a longer command; click Stop during thinking.

────────────────────────────────────────

ACT 5 — KNOWLEDGE (45 SEC)
--------------------------

Say: “Skills and docs live on disk and inject into every prompt.”

  1. Open Knowledge & skills (book icon).
  2. Show folder structure / add file.
  3. Ask a question that only your staged skill can answer.

────────────────────────────────────────

ACT 6 — ENGINEERING STORY (30 SEC CLOSE)
----------------------------------------

Say: “Under the hood: Tauri 2, React 19, Rust for shell and FS. CI builds macOS, Windows, and Linux installers.”

Show (optional, 10 sec): GitHub Actions or docs/ARCHITECTURE.md diagram.

Close: “Alpha today; roadmap includes hardened HITL, tests, and broader packaging.”

────────────────────────────────────────

FALLBACKS IF SOMETHING BREAKS
-----------------------------

  Issue                  |  Fallback line                                              
  Cloud API down         |  Switch to local Ollama                                     
  Ollama down            |  Show pre-recorded screenshot of shell block                
  Context empty (Linux)  |  “Optional packages xdotool/wl-paste; core chat still works”
  Permission banner      |  “macOS Accessibility—one-time grant”                       

────────────────────────────────────────

DO NOT DEMO ON A LIVE STREAM
----------------------------

  • Real rm -rf
  • Production API keys in view
  • Customer data paths
  • YOLO mode on a machine with secrets

────────────────────────────────────────

Built with ❤️ by Gnomad Studio 🦙

════════════════════════════════════════════════════════════════════════
Built with ❤️ by Gnomad Studio 🦙
https://gnomadstudio.org
════════════════════════════════════════════════════════════════════════