playrig 0.1.0 → 0.1.1

package/AGENTS.md

@@ -4,10 +4,10 @@ Playrig lets you control After Effects and Premiere Pro. You write a job script,
 
 | Edition | App | Job language | Job global |
 |---|---|---|---|
-| Playrig for After Effects (`ae`) | After Effects | ExtendScript (ES3), `.jsx` | `PLAYRIG` (`BRIDGE` is an alias) |
-| Playrig for Premiere Pro (`pr`) | Premiere Pro 25.6+ | modern JS in an async function body (`await` works), `.js` | `PLAYRIG` (`BRIDGE` is an alias), plus `ppro` (the `premierepro` module), `alert`, `confirm` |
+| `playrig-ae` (`ae`) | After Effects | ExtendScript (ES3), `.jsx` | `PLAYRIG` (`BRIDGE` is an alias) |
+| `playrig-pr` (`pr`) | Premiere Pro 25.6+ | modern JS in an async function body (`await` works), `.js` | `PLAYRIG` (`BRIDGE` is an alias), plus `ppro` (the `premierepro` module), `alert`, `confirm` |
 
-Only the editions the user installed work. Check which app is open and that its panel is started before submitting anything (with no panel answering, a job ends with "No result ... Is the app open with the Playrig panel started?").
+Playrig supports macOS only for now. Only the editions the user installed work. Check which app is open and that its panel is started before submitting anything (with no panel answering, a job ends with "No result ... Is the app open with the Playrig panel started?").
 
 ## Submit a job
 

package/README.md

@@ -2,17 +2,17 @@
 
 Playrig lets Claude, Codex or any coding agent control After Effects and Premiere Pro, so you can "vibe edit" your videos while keeping the control and sophistication these apps give you out of the box.
 
-It is one product with two editions: **Playrig for After Effects** and **Playrig for Premiere Pro**. Install one, or both.
+Playrig is one product made of separate packages: **`playrig`** (the command-line tool), **`playrig-ae`** (the After Effects panel) and **`playrig-pr`** (the Premiere Pro panel). Install the ones you need.
 
 ## Install
 
-Requires Node 18 or newer.
+Requires macOS and Node 18 or newer. Windows is not supported yet.
 
 ```bash
 npm install -g playrig      # the CLI: `playrig`, short alias `prg`
 
-playrig install ae          # Playrig for After Effects: panel into After Effects' ScriptUI Panels folder
-playrig install pr          # Playrig for Premiere Pro: builds "Playrig (PR).ccx" and opens the Creative Cloud installer
+playrig install ae          # playrig-ae: panel into After Effects' ScriptUI Panels folder
+playrig install pr          # playrig-pr: builds "Playrig (PR).ccx" and opens the Creative Cloud installer
 playrig install skills      # optional: agent skills (video workflow, recipes, scoring) into ./.claude/skills (--global for ~/.claude/skills)
 playrig install all         # whatever applies of the above
 ```

package/editions/ae/README.md

@@ -1,4 +1,4 @@
-# Playrig for After Effects
+# playrig-ae
 
 A folder-based link between Claude and a live After Effects project (AE 2026, macOS and Windows).
 Claude writes an ExtendScript job into a watched folder; a dockable panel runs it in your open project and writes back a log, errors, project inspection and PNG frames. You only render the final output.
@@ -41,7 +41,7 @@ Upgrading from "AE Bridge": delete `AE Bridge.jsx` and `AE Bridge lib/`; saved s
 ## The panel
 
 ```
-Playrig for After Effects                                ● Idle   ⏻   ⚙
+playrig-ae                                ● Idle   ⏻   ⚙
 Motion_Videos_AI                (open project)
 
 Recent jobs                                     35 jobs
@@ -51,7 +51,7 @@ Status        Action                    Time
 (summary of the selected job)                 [Details...]
 ```
 
-- **Power icon**: grey = stopped, green = running. **Gear**: Playrig for After Effects Settings (General: bridge folder, Start automatically, Back up the project file before each job; About).
+- **Power icon**: grey = stopped, green = running. **Gear**: playrig-ae Settings (General: bridge folder, Start automatically, Back up the project file before each job; About).
 - **Recent jobs is per project**: it shows the jobs of the project that is open (read from `EDIT_LOGS/results/` beside the `.aep`) and switches when you open another project, even while the bridge is stopped. Latest 50, newest first. For an unsaved project only this session's jobs show ("Save the project to keep its job history with it").
 - Select a row to see a one-line summary of what the job did under the list (ScriptUI has no per-row tooltips); **double-click** a row or press **Details...** for the job details window (what happened, action, id, start + duration, project, error, log, frames, returned value, result path). A `*` after an action means it was inferred from the script rather than declared.
 - Status uses an icon plus the word: ok (green), error (red), rejected (orange), timeout (amber), unknown (grey).
@@ -101,7 +101,7 @@ Rules for writing jobs are in `CLAUDE.md`.
 
 ## Project-folder log (travels with the project)
 
-After every job the panel mirrors its work into `EDIT_LOGS/` next to the `.aep` (the same folder name the Playrig for Premiere Pro uses; an older `AE-BRIDGE/` folder is renamed to it on the first job after the update):
+After every job the panel mirrors its work into `EDIT_LOGS/` next to the `.aep` (the same folder name the playrig-pr uses; an older `AE-BRIDGE/` folder is renamed to it on the first job after the update):
 
 ```
 <project folder>/EDIT_LOGS/
@@ -112,7 +112,7 @@ After every job the panel mirrors its work into `EDIT_LOGS/` next to the `.aep`
 └── assets.ae.md/.json  footage (relative paths, MISSING / EXTERNAL flags), comps and fonts, refreshed each job
 ```
 
-(`assets.ae.*` is named so it never overwrites the Playrig for Premiere Pro's `assets.md` when a Premiere and an AE project share a folder; `JOURNAL.md` is shared and each entry says which job it is. The panel's table and `playrig ae tail` only list results whose `project.path` is the open project.)
+(`assets.ae.*` is named so it never overwrites the playrig-pr's `assets.md` when a Premiere and an AE project share a folder; `JOURNAL.md` is shared and each entry says which job it is. The panel's table and `playrig ae tail` only list results whose `project.path` is the open project.)
 
 Move the whole project folder and a new session can read `JOURNAL.md` and `assets.ae.md` to see what was done and what is available. The root folder (`inbox/ out/ done/`) stays the transport; `EDIT_LOGS/` is the durable record. If the project has never been saved it has no folder: `result.sync` says so and the jobs are backfilled after the first job that runs on a saved project. Sync failures never fail a job; they are reported in `result.sync` (and by `aeb`). Footage outside the project folder is flagged EXTERNAL because it won't move with it; collect files into the project folder to make it portable.
 
@@ -123,7 +123,7 @@ Move the whole project folder and a new session can read `JOURNAL.md` and `asset
 - `project.dirty` is reported only if the scripting DOM exposes it; otherwise `null`.
 - Snapshots use `comp.saveFrameToPng` and then wait up to 10 s for the file to exist with non-zero size.
 - Closing the panel stops polling.
-- Project organization (folders/auto-filing, as in the Playrig for Premiere Pro) is deliberately **not** part of the Playrig for After Effects (decided with the user, 2026-10-02).
+- Project organization (folders/auto-filing, as in the playrig-pr) is deliberately **not** part of the playrig-ae (decided with the user, 2026-10-02).
 - Jobs share one persistent ExtendScript engine (`#targetengine "playrig"`), so globals can leak between jobs.
 
 ## Status of verification

package/editions/ae/lib/actions.json

@@ -1,5 +1,5 @@
 {
-  "_about": "Shared, engine-neutral data for the Playrig for After Effects: read by the ExtendScript panel, by aeb (Node) and, later, by a UXP port. Plain JSON on purpose. Labels and summaries are display text only: renaming one renames it for every past and future job.",
+  "_about": "Shared, engine-neutral data for the playrig-ae: read by the ExtendScript panel, by aeb (Node) and, later, by a UXP port. Plain JSON on purpose. Labels and summaries are display text only: renaming one renames it for every past and future job.",
   "logFolder": "EDIT_LOGS",
   "legacyLogFolder": "AE-BRIDGE",
   "recipePrefix": "recipe.",

package/editions/ae/lib/dev.jsxinc

@@ -1,4 +1,4 @@
-// DEV ONLY. Developer-facing extras for the Playrig for After Effects panel. This whole file is left out of packaged builds: the panel loads it only
+// DEV ONLY. Developer-facing extras for the playrig-ae panel. This whole file is left out of packaged builds: the panel loads it only
 // if it exists (File.exists + $.evalFile) and only uses $.global.PlayrigDev when it is defined, so removing the file removes these features
 // without any other change. Currently: the "Job script" section of the job details window (the script as it was run, for debugging jobs).
 $.global.PlayrigDev = {

package/editions/ae/lib/panel-core.jsxinc

@@ -1,4 +1,4 @@
-// Playrig for After Effects panel core: everything the panel needs that is NOT user interface. ES3 only.
+// playrig-ae panel core: everything the panel needs that is NOT user interface. ES3 only.
 // Loaded once by the panel (lib/ folder) and defines $.global.PlayrigCore. Kept free of ScriptUI on purpose so it can move to a UXP
 // port nearly unchanged: actions + job-header parsing/inference (data in actions.json), the per-project history reader and the
 // detail-text builder. File access goes through File/Folder only.

package/editions/ae/library-starter/README.md

@@ -26,7 +26,7 @@ When the library passes **40 recipes**, `playrig ae lib index` automatically tur
 
 For agents and for building whole scenes, the **`use-ae-recipes`** skill (`.claude/skills/use-ae-recipes/`) wraps this: it routes through the index, chains recipes, previews, tunes with you and assembles a master comp. To *add* recipes use **`create-ae-recipe`**.
 
-Needs After Effects open with the Playrig for After Effects panel started (see the edition README). Run from anywhere:
+Needs After Effects open with the playrig-ae panel started (see the edition README). Run from anywhere:
 
 ```bash
 playrig ae lib list <word>                # search ids, names, tags, aliases, summaries
@@ -136,7 +136,7 @@ playrig ae lib index                     # rebuild INDEX.md (+ categories/, inde
 - Add a category by creating a folder under `recipes/` and (optionally) a line in `categories.json` for its description.
 - Past 40 recipes the index splits by category automatically (`INDEX_SPLIT_THRESHOLD` in the CLI (`playrig/lib/ae.js`)).
 - `index.json` is the machine-readable catalogue (all metadata + params + path), for tools that prefer JSON.
-- The library is just a folder. Copy it anywhere, or point to it with `--lib <dir>` / `AE_LIBRARY`. The scripts are plain ExtendScript; the Playrig for After Effects is only needed to run them.
+- The library is just a folder. Copy it anywhere, or point to it with `--lib <dir>` / `AE_LIBRARY`. The scripts are plain ExtendScript; the playrig-ae is only needed to run them.
 - Preview images live **next to the recipe** as `<id>--t<seconds>.png` and are embedded in its `## Preview` block (between `<!-- previews:start -->` and `<!-- previews:end -->` markers, kept up to date by `--save-preview`). Moving or copying a recipe means moving its `.md` and its `<id>--t*.png` files together.
 
 ## Things to know

package/editions/ae/package.json

@@ -1,7 +1,7 @@
 {
   "name": "playrig-ae",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": true,
-  "description": "Playrig for After Effects: the ScriptUI panel, motion library and skills. Versioned on its own (tags ae-v*).",
+  "description": "playrig-ae: the ScriptUI panel, motion library and skills. Versioned on its own (tags ae-v*).",
   "license": "SEE LICENSE IN LICENSE"
 }

package/editions/ae/panel/Playrig.jsx

@@ -1,5 +1,5 @@
 #targetengine "playrig"
-// Playrig for After Effects: stub. This is the only file in After Effects' ScriptUI Panels folder, so it is also the
+// playrig-ae: stub. This is the only file in After Effects' ScriptUI Panels folder, so it is also the
 // panel's name in the Window menu. It stays tiny and stable, and loads the real panel (core.jsx) from the newest of:
 //   1. the user's data folder (<userData>/Playrig/ae/current), where verified updates are installed without admin rights
 //   2. "Playrig lib" next to this file, the copy that `playrig install ae` put there

package/editions/ae/panel/core.jsx

@@ -352,16 +352,16 @@
     }
 
     // ------------------------------------------------------------ project-folder sync
-    // Everything a job produces is mirrored into <project folder>/EDIT_LOGS/ (same folder name as Playrig for Premiere Pro; an older
+    // Everything a job produces is mirrored into <project folder>/EDIT_LOGS/ (same folder name as playrig-pr; an older
     // AE-BRIDGE/ folder is renamed to it on the first job) so the project can move to another machine and the next session can
     // read what was done and which assets exist.
     var WS_README = "# EDIT_LOGS\n\n" +
-        "Written automatically by Playrig for After Effects next to the .aep. Move this folder together with the project.\n\n" +
+        "Written automatically by playrig-ae next to the .aep. Move this folder together with the project.\n\n" +
         "- `JOURNAL.md`: chronological record of every job (newest last): what ran, status, errors, log, snapshots.\n" +
         "- `jobs/<id>.jsx` (+ `<id>.json` options): the exact scripts that were run on this project.\n" +
         "- `results/<id>/`: `result.json` and the PNG snapshots of each job.\n" +
         "- `assets.ae.md` / `assets.ae.json`: footage, comps and fonts in the project as of the last job (paths relative to the project folder). " +
-        "(Named `.ae` so they do not overwrite Playrig for Premiere Pro's `assets.md` when both projects share a folder.)\n\n" +
+        "(Named `.ae` so they do not overwrite playrig-pr's `assets.md` when both projects share a folder.)\n\n" +
         "To continue on another system: open the .aep, read `JOURNAL.md` and `assets.ae.md`, re-link any footage marked MISSING, " +
         "install the listed fonts, then submit new jobs with Playrig as usual. Re-running `jobs/*.jsx` in order rebuilds the scripted work.\n";
 

package/editions/ae/skills/create-ae-recipe/SKILL.md

@@ -5,7 +5,7 @@ description: Add a new recipe (reusable, parameterised After Effects effect, ele
 
 # create-ae-recipe
 
-You add one recipe at a time to `<library>/` (one Markdown file per recipe, see `<library>/README.md`). Recipes run in the user's **open** After Effects project through the Playrig for After Effects, so the work is: build it, **look at it**, show the user, iterate, then save it cleanly.
+You add one recipe at a time to `<library>/` (one Markdown file per recipe, see `<library>/README.md`). Recipes run in the user's **open** After Effects project through the playrig-ae, so the work is: build it, **look at it**, show the user, iterate, then save it cleanly.
 
 Two entry points, same finish:
 
@@ -20,7 +20,7 @@ Two entry points, same finish:
 playrig ae scratch start       # remember what's in the project before you add anything
 ```
 
-- After Effects must be open with the Playrig for After Effects panel started (status `Idle`). If a job times out, tell the user to start the panel.
+- After Effects must be open with the playrig-ae panel started (status `Idle`). If a job times out, tell the user to start the panel.
 - You are working inside the user's real project. **All experiments go in comps named `SCRATCH-<id>-v<n>`.** Never modify their existing layers/comps. Never save the project. Never run `scratch clean --yes` before reading its list and confirming every item is yours.
 - Each Playrig job is one Undo step; the user can Edit > Undo.
 - Fonts: check the requested font is installed (`textInfo.font` via inspect, or a visible substitution in the preview). Default is Inter.

package/editions/ae/skills/create-ae-recipe/references/ae-patterns.md

@@ -1,6 +1,6 @@
 # After Effects patterns for recipes
 
-Everything here was verified in After Effects 26.5 through the Playrig for After Effects while building the library. Scripts are **ExtendScript (ES3)**.
+Everything here was verified in After Effects 26.5 through the playrig-ae while building the library. Scripts are **ExtendScript (ES3)**.
 
 ## ES3 rules (the linter `playrig ae lib check` enforces most)
 

package/editions/ae/skills/create-ae-video/scripts/preflight.js

@@ -71,10 +71,10 @@ if (!ae || ae.status !== 'ok') {
   // Never leave a stale job behind: it would run later when the panel starts.
   for (const f of [`${id}.jsx`, `${id}.json`, `${id}.jsx.tmp`, `${id}.json.tmp`]) fs.rmSync(path.join(root, 'inbox', f), { force: true });
   const why = ae ? `job ${ae.status}: ${ae.error && ae.error.message}` : `no answer within ${waitSec}s`;
-  add('fail', 'After Effects + Playrig for After Effects panel', why, 'Open After Effects, then Window > Playrig and press Start (status "Idle"). First time? Install the panel: playrig install ae, and enable Settings > Scripting & Expressions > "Allow Scripts to Write Files and Access Network"');
+  add('fail', 'After Effects + playrig-ae panel', why, 'Open After Effects, then Window > Playrig and press Start (status "Idle"). First time? Install the panel: playrig install ae, and enable Settings > Scripting & Expressions > "Allow Scripts to Write Files and Access Network"');
 } else {
   const v = ae.returnValue;
-  add('ok', 'After Effects + Playrig for After Effects panel', `AE ${v.ae}, panel answering`);
+  add('ok', 'After Effects + playrig-ae panel', `AE ${v.ae}, panel answering`);
   add('ok', 'Open project', `${v.project.path || '(unsaved project)'}${v.project.dirty ? ', unsaved changes' : ''}; ${v.project.items} items, ${v.comps} comps${v.active ? `; active comp: ${v.active}` : ''}`);
   const missing = Object.entries(v.fonts).filter(([, ok]) => ok === false).map(([n]) => n);
   const unknown = Object.entries(v.fonts).filter(([, ok]) => ok === null).map(([n]) => n);

package/editions/ae/skills/use-ae-recipes/SKILL.md

@@ -5,13 +5,13 @@ description: Build After Effects scenes and videos from the user's motion librar
 
 # use-ae-recipes
 
-You turn a brief into finished comps inside the user's **open** After Effects project by running tested recipes from `<library>/` through the Playrig for After Effects: pick, chain, tune, assemble, show.
+You turn a brief into finished comps inside the user's **open** After Effects project by running tested recipes from `<library>/` through the playrig-ae: pick, chain, tune, assemble, show.
 
 Missing or unsuitable recipe? Switch to the **`create-ae-recipe`** skill rather than improvising a one-off. Don't render final output: that stays with the user (render queue / Media Encoder).
 
 ## 0. Preflight
 
-- After Effects open, Playrig for After Effects panel started (`Idle`). If a job times out, ask the user to start it.
+- After Effects open, playrig-ae panel started (`Idle`). If a job times out, ask the user to start it.
 - You are working in their real project. **Create new comps only**; don't touch existing comps/layers unless asked. Never save the project. Every run is one Undo step.
 - Commands are `playrig ae ...`. Helper-script paths below (`.claude/skills/...`) are relative to the project folder where the skills were installed (`playrig install skills`). `<library>` is the folder printed by `playrig where library`.
 - For frame review you'll use `.claude/skills/create-ae-recipe/scripts/media` (run its `setup.sh` once if `media check` fails).

package/editions/pr/README.md

@@ -1,4 +1,4 @@
-# Playrig for Premiere Pro (UXP) — v0.1 spike
+# playrig-pr (UXP) — v0.1 spike
 
 Same folder protocol as the After Effects edition (`inbox/ running/ done/ out/<id>/result.json`), driven by a UXP panel in Premiere Pro 25.6+.
 Jobs are **modern JavaScript** (async function bodies; `await` works) receiving `PLAYRIG` (`BRIDGE` is an alias), `ppro` (the `premierepro` module), `alert`, `confirm`.

package/editions/pr/SCORE_PROCESS.md

@@ -1,6 +1,6 @@
 # Adding a music score to Premiere sequences (draft process, for a future skill)
 
-Worked once on "Quadrant Chips Wide/Portrait" (7 s motion pieces). Epidemic Sound MCP + Playrig for Premiere Pro.
+Worked once on "Quadrant Chips Wide/Portrait" (7 s motion pieces). Epidemic Sound MCP + playrig-pr.
 
 ## Steps
 1. **Read the timeline, not just the brief.** Get each sequence's length, frame size and the moments that carry rhythm (here: chip pops every 0.6 s starting 2.6 s). Derive a music brief from them:

package/editions/pr/package.json

@@ -1,7 +1,7 @@
 {
   "name": "playrig-pr",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": true,
-  "description": "Playrig for Premiere Pro: the UXP panel and skills. Versioned on its own (tags pr-v*).",
+  "description": "playrig-pr: the UXP panel and skills. Versioned on its own (tags pr-v*).",
   "license": "SEE LICENSE IN LICENSE"
 }

package/editions/pr/plugin/index.js

@@ -320,7 +320,7 @@ async function collectAssets(project, projDir, sequenceNames) {
 
 function assetsMarkdown(a) {
   const media = a.items.filter((x) => x.kind === "media"), seqs = a.items.filter((x) => x.kind === "sequence");
-  let s = `# Project assets\n\nGenerated ${a.generatedAt} by Playrig for Premiere Pro. Relative paths are from the .prproj folder (\`${a.projectFolder}\`).\n\n`;
+  let s = `# Project assets\n\nGenerated ${a.generatedAt} by playrig-pr. Relative paths are from the .prproj folder (\`${a.projectFolder}\`).\n\n`;
   s += `## Sequences (${seqs.length})\n\n` + seqs.map((x) => `- ${x.name} (bin ${x.bin})`).join("\n") + "\n\n";
   s += `## Media (${media.length})\n\n`;
   for (const x of media) s += `- ${x.name} (bin ${x.bin}): \`${x.relative}\`${x.offline ? " **OFFLINE/MISSING**" : ""}\n`;
@@ -331,7 +331,7 @@ function assetsMarkdown(a) {
 // ------------------------------------------------------------ project-folder sync
 const WS_README = `# EDIT_LOGS
 
-Written automatically by the Playrig for Premiere Pro next to the .prproj. Move this folder with the project.
+Written automatically by the playrig-pr next to the .prproj. Move this folder with the project.
 
 - \`JOURNAL.md\`: chronological record of every job (newest last).
 - \`jobs/<id>.js\` (+ \`<id>.json\`): the exact scripts run on this project.

package/editions/pr/plugin/manifest.json

@@ -2,7 +2,7 @@
   "manifestVersion": 5,
   "id": "playrig.premiere",
   "name": "Playrig",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "main": "index.html",
   "host": {
     "app": "premierepro",

package/editions/pr/skills/score-video/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: score-video
-description: Add a music score plus sound effects to a finished video in Premiere Pro, using Epidemic Sound and the Playrig for Premiere Pro. Derives a music brief from the video's own timeline (mood, BPM from the motion cadence), finds and length-fits a track, picks SFX for the key moments, builds a typewriter bed, ducks the music under the effects with a measured sidechain, and lays everything on separate audio tracks as one undo step. Use when the user asks for a music bed, score, soundtrack, sound design, SFX, or "make it sound good" for a video or sequence, especially motion graphics made in After Effects.
+description: Add a music score plus sound effects to a finished video in Premiere Pro, using Epidemic Sound and the playrig-pr. Derives a music brief from the video's own timeline (mood, BPM from the motion cadence), finds and length-fits a track, picks SFX for the key moments, builds a typewriter bed, ducks the music under the effects with a measured sidechain, and lays everything on separate audio tracks as one undo step. Use when the user asks for a music bed, score, soundtrack, sound design, SFX, or "make it sound good" for a video or sequence, especially motion graphics made in After Effects.
 ---
 
 # score-video
@@ -10,7 +10,7 @@ You turn a finished (or nearly finished) picture into a scored one: music bed +
 **Ground rules:** work in the user's open Premiere project; add audio only, never touch picture; **never save the project**; every Premiere job is one undo step; downloads go in the project's own music/sound folders; say what you could not verify (you cannot listen: only measure).
 
 ## 0. Preflight (before asking anything)
-- Playrig for Premiere Pro answering: `playrig pr run "$(playrig where pr)/examples/hello.js" --id pre-$RANDOM`. If not, ask the user to start the panel (Window > Extensions > Playrig, then Start).
+- playrig-pr answering: `playrig pr run "$(playrig where pr)/examples/hello.js" --id pre-$RANDOM`. If not, ask the user to start the panel (Window > Extensions > Playrig, then Start).
 - Epidemic Sound tools available (`mcp__epidemic-sound__*`, load via ToolSearch: SearchRecordings, EditRecording, PollEditRecordingJob, DownloadRecordingEdit, SearchSoundEffects, DownloadSoundEffect). If missing, say so and stop; do not substitute other sources.
 - `ffmpeg`, `ffprobe` and `python3` on PATH.
 - Find the project folder from the job log (`project:` line) and look for its music/sound folders (e.g. `3_MUSIC`, `2_SOUND`). Use them; create `2_SOUND/SFX` if needed.

package/editions/pr/skills/score-video/scripts/place.js

@@ -1,4 +1,4 @@
-// Playrig for Premiere Pro job: lay the score + SFX on one or more sequences as ONE undo step.
+// playrig-pr job: lay the score + SFX on one or more sequences as ONE undo step.
 // Run:  playrig pr run .claude/skills/score-video/scripts/place.js --id place-<rand>
 // Edit CONFIG first (copy the placements from mix.py's JSON report). Modern JS, `await` works. Never saves the project.
 const CONFIG = {

package/lib/ae.js

@@ -1,5 +1,5 @@
 'use strict';
-// Playrig for After Effects client: submits ExtendScript (.jsx) jobs to the panel, reads results, runs the recipe library.
+// playrig-ae client: submits ExtendScript (.jsx) jobs to the panel, reads results, runs the recipe library.
 
 const fs = require('fs');
 const path = require('path');

package/lib/common.js

@@ -11,8 +11,8 @@ const BOOL_FLAGS = new Set(['no-undo', 'json', 'no-snap', 'save-preview', 'full'
 
 // The two editions. `ext` is the job file extension the panel watches for.
 const APPS = {
-  ae: { id: 'ae', name: 'After Effects', product: 'Playrig for After Effects', ext: '.jsx', legacyDir: 'AE Bridge', legacyEnv: 'AE_BRIDGE_ROOT' },
-  pr: { id: 'pr', name: 'Premiere Pro', product: 'Playrig for Premiere Pro', ext: '.js', legacyDir: 'Premiere Bridge', legacyEnv: 'PREMIERE_BRIDGE_ROOT' },
+  ae: { id: 'ae', name: 'After Effects', product: 'playrig-ae', ext: '.jsx', legacyDir: 'AE Bridge', legacyEnv: 'AE_BRIDGE_ROOT' },
+  pr: { id: 'pr', name: 'Premiere Pro', product: 'playrig-pr', ext: '.js', legacyDir: 'Premiere Bridge', legacyEnv: 'PREMIERE_BRIDGE_ROOT' },
 };
 
 const USAGE = `Playrig: let a coding agent control After Effects and Premiere Pro.

package/lib/install.js

@@ -134,6 +134,7 @@ function installSkills(flags) {
 
 function install(pos, flags) {
   const what = pos[0];
+  if (process.platform !== 'darwin' && what !== 'skills') die('Playrig supports macOS only for now (Windows is not supported yet).', 1);
   if (what === 'ae') return installAE(flags);
   if (what === 'pr') return installPR(flags);
   if (what === 'skills') return installSkills(flags);

package/lib/payload.js

@@ -57,4 +57,28 @@ function prPackage(outFile) {
   return { version: readJSON(path.join(ed, 'plugin', 'manifest.json')).version, file: outFile };
 }
 
-module.exports = { STUB_API, aePayload, prPackage, zipFolder, editionVersion, readJSON };
+// A download for people who don't use Terminal: the stub, the payload folder and a one-page guide, to drag into ScriptUI Panels.
+const INSTALL_TXT = `playrig-ae: manual install (macOS)
+
+1. Quit After Effects.
+2. In Finder choose Go > Go to Folder... and paste:
+   /Applications/Adobe After Effects <your version>/Scripts/ScriptUI Panels
+3. Drag Playrig.jsx and the folder "Playrig lib" from this download into that folder.
+   Enter your Mac password when asked. If a "Playrig lib" folder is already there, replace it.
+4. Start After Effects. Open Preferences > Scripting & Expressions and turn on
+   "Allow Scripts to Write Files and Access Network".
+5. Restart After Effects, open Window > Playrig and press Start.
+
+Later updates install from the panel: Settings > About > Check for Updates.
+Use of Playrig is covered by LICENSE.txt (inside "Playrig lib").
+`;
+function aeInstallBundle(dest, version) {
+  const ed = C.editionDir('ae');
+  fs.rmSync(dest, { recursive: true, force: true });
+  fs.mkdirSync(dest, { recursive: true });
+  aePayload(path.join(dest, 'Playrig lib'), version);
+  fs.copyFileSync(path.join(ed, 'panel', 'Playrig.jsx'), path.join(dest, 'Playrig.jsx'));
+  fs.writeFileSync(path.join(dest, 'INSTALL.txt'), INSTALL_TXT);
+}
+
+module.exports = { aeInstallBundle, STUB_API, aePayload, prPackage, zipFolder, editionVersion, readJSON };

package/lib/pr.js

@@ -1,5 +1,5 @@
 'use strict';
-// Playrig for Premiere Pro client: submits JavaScript (.js) jobs to the UXP panel, reads results.
+// playrig-pr client: submits JavaScript (.js) jobs to the UXP panel, reads results.
 
 const fs = require('fs');
 const path = require('path');

package/lib/update.js

@@ -77,7 +77,7 @@ async function updateAE(entry, custom) {
     if (fs.existsSync(path.join(base, 'current'))) fs.renameSync(path.join(base, 'current'), path.join(base, 'previous'));
     fs.renameSync(fresh, path.join(base, 'current'));
   } finally { fs.rmSync(tmp, { recursive: true, force: true }); fs.rmSync(fresh, { recursive: true, force: true }); }
-  console.log(`Playrig for After Effects ${entry.version} installed. Restart After Effects to use it.`);
+  console.log(`playrig-ae ${entry.version} installed. Restart After Effects to use it.`);
 }
 
 async function updatePR(entry, custom) {
@@ -92,6 +92,7 @@ async function updatePR(entry, custom) {
 
 async function update(pos, flags) {
   const what = pos[0];
+  if (process.platform !== 'darwin' && (what === 'ae' || what === 'pr')) C.die('Playrig supports macOS only for now (Windows is not supported yet).', 1);
   if (what && !['ae', 'pr', 'cli'].includes(what)) C.die('Usage: playrig update [ae|pr|cli] [--check]');
   const { feed, custom } = await getFeed();
   const have = {
@@ -99,7 +100,7 @@ async function update(pos, flags) {
     pr: C.editionDir('pr') ? P.readJSON(path.join(C.editionDir('pr'), 'plugin', 'manifest.json')).version : null,
     cli: P.readJSON(path.join(C.CLI_DIR, 'package.json')).version,
   };
-  const names = { ae: 'Playrig for After Effects', pr: 'Playrig for Premiere Pro', cli: 'playrig CLI' };
+  const names = { ae: 'playrig-ae', pr: 'playrig-pr', cli: 'playrig' };
   let pending = 0;
   for (const id of (what ? [what] : ['ae', 'pr', 'cli'])) {
     const e = feed[id];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playrig",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Playrig lets Claude, Codex or any coding agent control After Effects and Premiere Pro.",
   "bin": {
     "playrig": "bin/playrig.js",

package/skills/create-video/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: create-video
-description: End-to-end workflow for making a short motion video with Claude across After Effects, Premiere Pro and Epidemic Sound, using the Playrig for After Effects and Playrig for Premiere Pro, in the user's own project layout. Covers brief and storyboard, building scenes in AE (wide AND portrait), keeping AE tidy, rendering, syncing to Premiere sequences, scoring (music + SFX) via score-video, and exporting to the project's final folders. Use at the start of any request to make, animate, recreate, sync, score or export a video, or when the user continues a video already in progress ("update the pills", "sync it with Premiere", "export the video").
+description: End-to-end workflow for making a short motion video with Claude across After Effects, Premiere Pro and Epidemic Sound, using the playrig-ae and playrig-pr, in the user's own project layout. Covers brief and storyboard, building scenes in AE (wide AND portrait), keeping AE tidy, rendering, syncing to Premiere sequences, scoring (music + SFX) via score-video, and exporting to the project's final folders. Use at the start of any request to make, animate, recreate, sync, score or export a video, or when the user continues a video already in progress ("update the pills", "sync it with Premiere", "export the video").
 ---
 
 # create-video

package/skills/create-video/scripts/premiere/export-sequences.js

@@ -1,4 +1,4 @@
-// Playrig for Premiere Pro job: export sequences immediately with a Media Encoder preset.
+// playrig-pr job: export sequences immediately with a Media Encoder preset.
 // This job does NOT check for existing files: `ls` the target folder first and never overwrite an existing export without asking.
 // Finals go to <project>/5_FINAL/Wide and 5_FINAL/Vertical with a _FINAL suffix; drafts to 4_EXPORTS.
 // Run: playrig pr run <this file> --id export-$(date +%s) --timeout 400

package/skills/create-video/scripts/premiere/make-sequences.js

@@ -1,4 +1,4 @@
-// Playrig for Premiere Pro job: import AE renders and create one sequence per render (size taken from the clip). Never saves.
+// playrig-pr job: import AE renders and create one sequence per render (size taken from the clip). Never saves.
 // Run: playrig pr run <this file> --id seq-$(date +%s)
 const CONFIG = {
   items: [   // render file -> sequence name

package/skills/create-video/scripts/premiere/swap-media.js

@@ -1,4 +1,4 @@
-// Playrig for Premiere Pro job: swap a sequence's picture (V1) and audio clips to NEW files, in place, as one undo step.
+// playrig-pr job: swap a sequence's picture (V1) and audio clips to NEW files, in place, as one undo step.
 // Overwrite replaces the clip underneath; pad replacement audio to the OLD clip's length so no remnant is left.
 // (createRemoveItemsAction does not work through Playrig.) Never overwrite a file Premiere has imported: new file names only.
 // Run: playrig pr run <this file> --id swap-$(date +%s)