docs: simplify README quick start demo

Author: tbcrawford

README.md

@@ -15,36 +15,13 @@ brew install tbcrawford/tap/opm
 
 ## Quick Start
 
-<p align="center">
-  <img src="assets/demo/readme-quick-start.gif" alt="Terminal demo showing opm init, create work, use work, and list" width="720" />
-</p>
-
-```sh
-# migrate your current OpenCode config once
-❯ opm init
-✓ Initialized opm
-  Migrated ~/.config/opencode → profiles/default
-
-# create a second environment for a different context
-❯ opm create work
-✓ Created profile work
-  profiles/work/
-
-# switch instantly, then reload OpenCode
-❯ opm use work
-✓ default → work
-  ~/.config/opencode → profiles/work
-
-❯ opm list
-○ default
-● work
-```
-
 Each profile is a full OpenCode config directory. Switching changes what `~/.config/opencode` points to, so OpenCode keeps using the same path it already knows.
 
 That is the whole flow: one command to switch, same path, no config surgery.
 
-<br>
+<p align="center">
+  <img src="assets/demo/readme-quick-start.gif" alt="Terminal demo showing opm init, create work, use work, and list" width="720" />
+</p>
 
 ---
 
@@ -79,8 +56,6 @@ Nothing leaks between profiles unless you explicitly copy it.
 - **Transparent**: OpenCode still reads and writes `~/.config/opencode` like it always has.
 - **Low overhead**: no wrapper workflow, no special edit path, no new mental model after setup.
 
-<br>
-
 ---
 
 ## Install
@@ -103,8 +78,6 @@ go install github.com/tbcrawford/opm@latest
 
 Download the latest release from [GitHub Releases](https://github.com/tbcrawford/opm/releases), extract it, and place `opm` in your `$PATH`.
 
-<br>
-
 ---
 
 ## Command Reference
@@ -134,8 +107,6 @@ opm completion zsh  > "${fpath[1]}/_opm"           # zsh
 opm completion fish > ~/.config/fish/completions/opm.fish  # fish
 ```
 
-<br>
-
 ---
 
 ## How it works

assets/demo/readme-quick-start.gif

@@ -27,34 +27,36 @@ Type "just assemble"
 Enter
 Type "export DEMO_HOME=$(mktemp -d)"
 Enter
+Type "export HOME=$DEMO_HOME"
+Enter
 Type "export PATH=$PWD:$PATH"
 Enter
-Type "mkdir -p $DEMO_HOME/.config/opencode"
+Type "mkdir -p $HOME/.config/opencode"
 Enter
-Type "echo Demo profile > $DEMO_HOME/.config/opencode/AGENTS.md"
+Type "echo Demo profile > $HOME/.config/opencode/AGENTS.md"
 Enter
 Type "clear"
 Enter
 Show
 
-Type "HOME=$DEMO_HOME opm init"
+Type "opm init"
 Enter
 Sleep 1.2s
 
-Type "HOME=$DEMO_HOME opm create work"
+Type "opm create work"
 Enter
 Sleep 1.0s
 
-Type "HOME=$DEMO_HOME opm use work"
+Type "opm use work"
 Enter
 Sleep 1.0s
 
-Type "HOME=$DEMO_HOME opm list"
+Type "opm list"
 Enter
 Sleep 1.5s
 
 Hide
 Type "rm -f opm"
 Enter
-Type "rm -rf $DEMO_HOME"
+Type "rm -rf $HOME"
 Enter

demo/readme-quick-start.tape

@@ -59,6 +59,7 @@ The output should stay close to the real CLI, but the README may still keep a li
 The tape should:
 
 - create and use an isolated temporary `HOME`
+- export the temporary `HOME` during hidden setup so the visible demo can show plain `opm` commands
 - seed `~/.config/opencode` with a minimal real directory so `opm init` migrates something meaningful
 - run the built `opm` binary or the repo's standard developer entrypoint in a way that works from the repo checkout
 - cleanly show the commands and success output for `init`, `create`, `use`, and `list`
@@ -71,13 +72,13 @@ The tape should not:
 
 ## README Integration
 
-The README should embed the GIF directly below `## Quick Start` and above the shell snippet.
+The README should embed the GIF directly below `## Quick Start` and replace the now-redundant shell snippet.
 
 The embed should:
 
 - render at a medium width appropriate for the quick-start section
 - use alt text that makes sense for readers and accessibility tools
-- keep the existing quick-start code block beneath it
+- keep the short explanatory copy beneath it
 
 The README should not add a large maintenance section. The demo should feel like a natural part of the quick-start section, not a separate documentation feature.