demoman 0.2.0-rc.5 → 0.2.0-rc.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,19 +2,28 @@
2
2
 
3
3
  Polished demo videos of web apps, made by your coding agent.
4
4
 
5
- Ask Claude Code for a demo of a flow — "make a demo of the new checkout" —
6
- and Demoman drives the app in its own browser window, films it, and saves
7
- the video to `~/Downloads`.
5
+ Ask your coding agent for a demo of a flow — "make a demo of the new
6
+ checkout" — and Demoman drives the app in its own browser window, films it,
7
+ and saves the video to `~/Downloads`.
8
8
 
9
9
  ## Install
10
10
 
11
- macOS, Node 20 or later, and Claude Code:
11
+ macOS, Node 20 or later, and Claude Code, Codex or Cursor:
12
12
 
13
13
  npx demoman setup
14
14
 
15
- Setup downloads Chromium (about 190 MB) and installs the Demoman plugin for
16
- Claude Code. Restart Claude Code, then ask for a demo — for example,
17
- "make a demo of demoman.io/sample".
15
+ Setup downloads Chromium (about 190 MB) and connects Demoman to each coding
16
+ agent it finds: the plugin for Claude Code and Codex, and an entry in
17
+ `~/.cursor/mcp.json` plus the `record-demo` skill for Cursor. It lets
18
+ Demoman's tools run without asking, and says so for each agent. Restart the
19
+ agent, then ask for a demo — for example, "make a demo of
20
+ demoman.io/sample". Run setup again after an update, or after removing the
21
+ Node that ran it: Cursor's entry names that Node's `npx`.
22
+
23
+ Another MCP client is expected to work, not yet run: give it this stdio
24
+ server.
25
+
26
+ {"command": "npx", "args": ["-y", "demoman@0.2.0-rc.7", "mcp"]}
18
27
 
19
28
  For an app behind a login, sign in once yourself:
20
29
 
@@ -22,6 +31,43 @@ For an app behind a login, sign in once yourself:
22
31
 
23
32
  That is the way for a real account, single sign-on and two-factor.
24
33
 
34
+ ## Other agents
35
+
36
+ Each takes the stdio server under Install and the `record-demo` skill,
37
+ which tells the agent to read Demoman's recipe first. OpenCode has made a
38
+ video this way; the others are expected to work, not yet run. Fetch the
39
+ skill into the agent's skills folder:
40
+
41
+ curl -fsSL --create-dirs -o <skills folder>/record-demo/SKILL.md \
42
+ https://raw.githubusercontent.com/demoman-io/plugins/main/skills/record-demo/SKILL.md
43
+
44
+ **OpenCode.** In `~/.config/opencode/opencode.json`; skills folder
45
+ `~/.config/opencode/skills`.
46
+
47
+ {"mcp": {"servers": {"demoman": {"type": "local",
48
+ "command": ["npx", "-y", "demoman@0.2.0-rc.7", "mcp"]}}}}
49
+
50
+ **Pi.** Skills folder `~/.pi/agent/skills`.
51
+
52
+ pi mcp add demoman -- npx -y demoman@0.2.0-rc.7 mcp
53
+
54
+ **Kimi Code.** The block under Install, under `mcpServers`, in
55
+ `~/.kimi-code/mcp.json`; skills folder `~/.kimi-code/skills`. Kimi Code
56
+ asks before each call unless `~/.kimi-code/config.toml` allows them:
57
+
58
+ [[permission.rules]]
59
+ decision = "allow"
60
+ pattern = "mcp__demoman__*"
61
+
62
+ **Hermes**, run on this Mac. Skills folder `~/.hermes/skills`.
63
+
64
+ hermes mcp add demoman --command npx --args -y demoman@0.2.0-rc.7 mcp
65
+
66
+ **DeepSeek's dsh.** A `@deepseek-ai/dsh-mcp-client` row in
67
+ `~/.dsh/profiles/web/cordis.patch.yml` with `transport: stdio`, `command:
68
+ npx`, `args: ['-y', 'demoman@0.2.0-rc.7', 'mcp']` and `cwd` set to your
69
+ project; skills folder `~/.dsh/skills`.
70
+
25
71
  ## Demo accounts
26
72
 
27
73
  For an app you run locally, the agent creates a demo account and its data,
@@ -35,6 +81,10 @@ site it may be typed on, and check the account with:
35
81
  DEMOMAN_SECRET_SELLER_PASSWORD_ORIGIN=https://staging.example.com \
36
82
  npx demoman signin --account seller
37
83
 
84
+ On your own machine, keep secrets in `.demoman/secrets.env`, not your shell:
85
+ an agent may pass Demoman only part of its environment — Codex does — so a
86
+ variable exported in your shell may never reach it.
87
+
38
88
  ## What it contacts
39
89
 
40
90
  Demoman runs on your machine. Its browser opens only the pages your agent
@@ -1,4 +1,4 @@
1
- demoman 0.2.0-rc.5 includes code from these packages, bundled into dist/:
1
+ demoman 0.2.0-rc.7 includes code from these packages, bundled into dist/:
2
2
 
3
3
  == dom-accessibility-api 0.7.1 (MIT) ==
4
4
  Source: https://www.npmjs.com/package/dom-accessibility-api/v/0.7.1
@@ -492,5 +492,6 @@ These packages are installed beside demoman as its dependencies, each under its
492
492
  - gifenc 1.0.3 (MIT)
493
493
  - mediabunny 1.55.2 (MPL-2.0)
494
494
  - playwright 1.62.1 (Apache-2.0)
495
+ - smol-toml 1.9.0 (BSD-3-Clause)
495
496
  - tldts 7.4.10 (MIT)
496
497
  - zod 4.4.3 (MIT)