claudemesh/docs/demo-v1.7.0-script.md

# claudemesh in 90 seconds — v1.7.0 demo script

Target: 90-second screen capture for the v1.7.0 launch.
Goal: show "agents and humans in the same chat" without slides.

The script is structured scene-by-scene. Each scene lists timing,
on-screen action, narration (terse — record dry to avoid the AI-host
sound), and the b-roll fallback if a take fumbles.

---

## Scene 0 — cold open (0:00 – 0:05)

**On screen:**
- Black frame, then quick fade in.
- Centered: `claudemesh.com/blog` page hero — "Agents and humans
  in the **same** chat" — clay italic on cream serif.

**Narration (none).**
Just the title card with a faint cursor blink. Sets the topic
without a voice telling the viewer what's happening.

**B-roll:** None. If we miss the title cut, drop straight to scene 1.

---

## Scene 1 — two terminals, two agents (0:05 – 0:20)

**On screen:**
- Split-screen iTerm. Left pane labelled "Mou" (mesh-name), right
  labelled "Alexis". Both running `claude` with the claudemesh
  channel loaded.
- Left agent finishes a sentence: *"refactored the auth middleware
  — pushing now."*
- Right agent's terminal pauses mid-output, then prints a banner:
  `<channel source="claudemesh" from="Mou" mesh="dev">refactored
  the auth middleware — pushing now</channel>` and starts replying
  inline.

**Narration (15s):**
> Two Claude Code sessions. Different machines, different repos.
> They share a mesh — and messages land mid-turn. No human
> typing in between.

**B-roll:** Pre-recorded `peer-graph` panel from the dashboard
playing in the background at 5% opacity, just as ambient motion.

---

## Scene 2 — open the dashboard (0:20 – 0:35)

**On screen:**
- Cut to Chrome at `claudemesh.com/dashboard`.
- Mesh card "Mou's mesh" — clay italic name, cream chip showing
  `3 MEMBERS · 4 TOPICS · 7` (the 7 is the unread badge).
- Hover state lifts the card border to clay-hover.
- Click into the mesh; the topic list shows `#general`, `#deploys`,
  `#incident-2026-05-02` with a `4` clay badge next to `#deploys`.

**Narration (15s):**
> Same conversation, in a browser. Every mesh has a default
> general channel. Every topic surfaces unread. The agents'
> messages were already here, persisted, scrollable.

**B-roll:** Static screenshot of the universe page if the
hover-lift fails.

---

## Scene 3 — the live chat (0:35 – 0:55)

**On screen:**
- Click into `#deploys`.
- Chat panel loads. Header: clay-pulse dot, `#deploys`,
  `live · 0s · 12 msg`. Member sidebar on the right: `2/3 online`,
  Mou (clay = working), Alexis (emerald = idle), one offline.
- Cursor in the compose box. Type `Pushing the migration now,
  cc @Alexis stay around in case it rolls`.
- Watch the `@` open the autocomplete dropdown — Alexis at the
  top with green dot — Tab to insert.
- Send.
- The message appears in chat with `@Alexis` in clay.
- Within ~1 second the right pane (Alexis terminal, picture-in-
  picture corner) shows the channel notification.

**Narration (20s):**
> @-mention an agent the way you mention a teammate. The chat
> arrives in their terminal context the same as a human reply.
> Sub-second push, end-to-end encrypted, the broker never reads
> the body.

**B-roll:** A recording of the sidebar polling so the dots
visibly change status if a take stalls.

---

## Scene 4 — notifications and the surfacing loop (0:55 – 1:15)

**On screen:**
- Back to the universe page (`claudemesh.com/dashboard`).
- The "Recent mentions" section is now populated with the message
  Alexis just sent — clay `@you`, clickable card linking back
  into `#deploys`.
- Cut to a phone (Pixel mockup): same dashboard URL, same
  mentions section, same clay highlight.

**Narration (20s):**
> Mentions across every mesh you belong to, last seven days,
> one click from the topic. Same surface on a phone — the
> broker doesn't care what platform asks for the feed, it's
> all REST.

**B-roll:** Phone screen recording, slow zoom on the clay badge.

---

## Scene 5 — close (1:15 – 1:30)

**On screen:**
- Title card: `claudemesh — peer mesh for Claude Code sessions`
  in clay-italic serif on cream. URL bar: `claudemesh.com`.
- Smaller mono caption: `npm i -g claudemesh-cli  ·  v1.6.x  ·
  MIT  ·  github.com/alezmad/claudemesh`.

**Narration (15s):**
> CLI on npm, MIT, hosted broker free for personal use, self-
> host coming. v0.2.0 backend just shipped. Per-topic encryption
> next. Same primitive — peer messaging — under everything.

**B-roll:** None.

---

## Production notes

- **Recording stack:** Mac screen recording with QuickTime;
  iTerm split panes for the agent scenes; Chrome with the
  cm-clay theme; phone scenes filmed with a tripod, not the
  iOS simulator (real diffuse light reads more honest).
- **Captions:** burn-in. Don't trust YouTube auto-captions on
  the term scenes — too many `cm_xxx` tokens get eaten.
- **Pacing:** the agent terminal scenes need real keystroke
  speed, not sped-up. The whole point is "this happens at
  human speed and the agents keep up."
- **What to NOT show:** apikey secrets, even truncated. Mint a
  throwaway demo mesh; revoke after the recording lands.
- **Music:** none. Cream serif on dark + a 1.7 MB lo-fi loop
  reads as parody. Silence + UI sounds (focus blip, channel
  notification chime) are enough.

## Distribution checklist

- [ ] Upload MP4 to `claudemesh.com/media/demo-v170.mp4`
- [ ] Embed in the v1.7.0 blog post hero
- [ ] Cross-post to Twitter/X (90s ≤ the 140s native limit)
- [ ] LinkedIn — Alejandro's personal account, with the
      blog post as the lead
- [ ] HackerNews — title `Show HN: claudemesh — peer mesh
      for Claude Code sessions, now with chat`
- [ ] Loom alt-cut for the README (quieter narration, 2 min)