premiere-cli 0.2.0__tar.gz → 0.3.0__tar.gz

{premiere_cli-0.2.0/src/premiere_cli.egg-info → premiere_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: premiere-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: Drive Adobe Premiere Pro from the command line: a Python CLI plus a bundled CEP bridge panel exposing Premiere's scripting APIs over local HTTP
 License: CC-BY-SA-4.0
 Project-URL: Repository, https://github.com/stefanwebb/premiere-cli
@@ -22,16 +22,17 @@ ExtendScript / QE scripting APIs as ~230 JSON-in/JSON-out commands —
 reading project/sequence/clip state, editing the timeline, applying
 effects, managing markers and bins, exporting media and frames, and more.
 
-It is also a **Claude Code plugin**: install it and Claude gets a skill
-documenting every command, so it can inspect and edit your open Premiere
-project for you.
+The Claude Code skill for driving this CLI lives in the separate
+[premiere-ai-skills](https://github.com/stefanwebb/premiere-ai-skills)
+plugin, alongside the AI-assisted workflow skills — install that plugin
+to give Claude the skill.
 
 ## Install
 
 ```bash
 # 1. The CLI (isolated, no dependencies)
-pipx install git+https://github.com/stefanwebb/premiere-cli
-#    or: uv tool install git+https://github.com/stefanwebb/premiere-cli
+pipx install premiere-cli
+#    or: uv tool install premiere-cli
 
 # 2. The CEP panel (copies it into Adobe's extensions dir + enables PlayerDebugMode)
 premiere-cli install-panel
@@ -42,6 +43,10 @@ premiere-cli install-panel
 premiere-cli doctor
 ```
 
+`premiere-cli init-project <name> --base-dir <path>` scaffolds a fresh,
+empty `.prproj` from a bundled template — no Premiere Pro session needed,
+so it works before step 3.
+
 Supported: macOS and Windows (CEP does not exist on Linux). The panel
 targets Premiere Pro 2020+ (CEP 10-12); the API behavior notes in
 [docs/BUILD_FINDINGS.md](docs/BUILD_FINDINGS.md) were live-calibrated on
@@ -65,8 +70,8 @@ Every command prints a JSON object: `{"ok": true, "result": ...}` or
 ## Use from Claude Code
 
 ```
-/plugin marketplace add stefanwebb/premiere-cli
-/plugin install premiere-cli@premiere-cli
+/plugin marketplace add stefanwebb/premiere-ai-skills
+/plugin install premiere-ai-skills@premiere-ai-skills
 ```
 
 This gives Claude the `premiere-cli` skill — a complete, behavior-annotated

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/README.md

@@ -9,16 +9,17 @@ ExtendScript / QE scripting APIs as ~230 JSON-in/JSON-out commands —
 reading project/sequence/clip state, editing the timeline, applying
 effects, managing markers and bins, exporting media and frames, and more.
 
-It is also a **Claude Code plugin**: install it and Claude gets a skill
-documenting every command, so it can inspect and edit your open Premiere
-project for you.
+The Claude Code skill for driving this CLI lives in the separate
+[premiere-ai-skills](https://github.com/stefanwebb/premiere-ai-skills)
+plugin, alongside the AI-assisted workflow skills — install that plugin
+to give Claude the skill.
 
 ## Install
 
 ```bash
 # 1. The CLI (isolated, no dependencies)
-pipx install git+https://github.com/stefanwebb/premiere-cli
-#    or: uv tool install git+https://github.com/stefanwebb/premiere-cli
+pipx install premiere-cli
+#    or: uv tool install premiere-cli
 
 # 2. The CEP panel (copies it into Adobe's extensions dir + enables PlayerDebugMode)
 premiere-cli install-panel
@@ -29,6 +30,10 @@ premiere-cli install-panel
 premiere-cli doctor
 ```
 
+`premiere-cli init-project <name> --base-dir <path>` scaffolds a fresh,
+empty `.prproj` from a bundled template — no Premiere Pro session needed,
+so it works before step 3.
+
 Supported: macOS and Windows (CEP does not exist on Linux). The panel
 targets Premiere Pro 2020+ (CEP 10-12); the API behavior notes in
 [docs/BUILD_FINDINGS.md](docs/BUILD_FINDINGS.md) were live-calibrated on
@@ -52,8 +57,8 @@ Every command prints a JSON object: `{"ok": true, "result": ...}` or
 ## Use from Claude Code
 
 ```
-/plugin marketplace add stefanwebb/premiere-cli
-/plugin install premiere-cli@premiere-cli
+/plugin marketplace add stefanwebb/premiere-ai-skills
+/plugin install premiere-ai-skills@premiere-ai-skills
 ```
 
 This gives Claude the `premiere-cli` skill — a complete, behavior-annotated

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "premiere-cli"
 # Keep in lockstep with premiere_cli.__version__ and PANEL_VERSION in
 # src/premiere_cli/panel/js/main.js.
-version = "0.2.0"
+version = "0.3.0"
 description = "Drive Adobe Premiere Pro from the command line: a Python CLI plus a bundled CEP bridge panel exposing Premiere's scripting APIs over local HTTP"
 readme = "README.md"
 license = {text = "CC-BY-SA-4.0"}
@@ -34,4 +34,5 @@ where = ["src"]
 premiere_cli = [
     "panel/**/*",
     "panel/.debug",
+    "templates/**/*",
 ]

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/src/premiere_cli/__init__.py

@@ -8,4 +8,4 @@ server (port 47823).
 # Kept in lockstep with PANEL_VERSION in panel/js/main.js and the version in
 # pyproject.toml — `premiere-cli doctor` compares the installed panel's
 # version against this one.
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/src/premiere_cli/cli.py

@@ -104,6 +104,20 @@ def main() -> None:
         help="Diagnose the CLI -> panel -> Premiere chain: panel installed, panel reachable, versions matching, Premiere responding",
     )
 
+    init_project_parser = subparsers.add_parser(
+        "init-project",
+        help="Create a fresh, empty Premiere Pro project from the bundled empty-project template",
+    )
+    init_project_parser.add_argument("project_name", help="Name of the new project, e.g. project0002")
+    init_project_parser.add_argument(
+        "--series", default=None,
+        help="Optional series name; the project is nested under <base-dir>/<series>/<project_name>",
+    )
+    init_project_parser.add_argument(
+        "--base-dir", required=True,
+        help="Directory the project (or series) is created under",
+    )
+
     create_sequence_parser = subparsers.add_parser("create-sequence", help="Create a new sequence")
     create_sequence_parser.add_argument("--name", required=True, help="Name of the new sequence")
     create_sequence_parser.add_argument(
@@ -2155,6 +2169,10 @@ def main() -> None:
         from premiere_cli import panel_install
 
         sys.exit(panel_install.doctor(port=args.port))
+    if args.subcommand == "init-project":
+        from premiere_cli import init_project
+
+        sys.exit(init_project.init_project(args.project_name, args.series, args.base_dir))
 
     if args.subcommand == "create-sequence":
         command_args = {"name": args.name, "bin": args.bin, "fps": args.fps, "width": args.width, "height": args.height}

premiere_cli-0.3.0/src/premiere_cli/init_project.py

@@ -0,0 +1,73 @@
+"""Create a fresh, empty Premiere Pro project from the bundled empty-project
+template.
+
+The template (``premiere_cli/templates/empty-project/``) ships inside this
+package, so ``premiere-cli init-project`` works from any checkout/install
+without needing access to a shared drive.
+"""
+
+import json
+import os
+import shutil
+from importlib import resources
+
+
+def _template_dir() -> str:
+    """Filesystem path of the empty-project template bundled inside this package."""
+    template = resources.files("premiere_cli") / "templates" / "empty-project"
+    path = str(template)
+    if not os.path.isdir(path):
+        raise RuntimeError(
+            f"bundled empty-project template not found at {path} — broken installation?"
+        )
+    return path
+
+
+def create_project(project_name: str, dest_dir: str) -> str:
+    """Copy the bundled empty-project template into dest_dir and rename its
+    .prproj file to '<project_name>.prproj'. Returns dest_dir.
+
+    Raises RuntimeError if dest_dir already exists or the template doesn't
+    contain exactly one .prproj file.
+    """
+    template_dir = _template_dir()
+
+    if os.path.exists(dest_dir):
+        raise RuntimeError(f"destination already exists, refusing to overwrite: {dest_dir}")
+
+    shutil.copytree(template_dir, dest_dir)
+
+    # Copying across some filesystems (e.g. exFAT external drives) emits
+    # AppleDouble sidecar files (e.g. "._Untitled.prproj") for xattrs/resource
+    # forks. Strip them from the copy so they don't get mistaken for real files.
+    for root, _dirs, files in os.walk(dest_dir):
+        for f in files:
+            if f.startswith("._"):
+                os.remove(os.path.join(root, f))
+
+    prproj_files = [f for f in os.listdir(dest_dir) if f.endswith(".prproj")]
+    if len(prproj_files) != 1:
+        raise RuntimeError(
+            f"expected exactly one .prproj file in the template, found {len(prproj_files)}: {prproj_files}"
+        )
+
+    old_path = os.path.join(dest_dir, prproj_files[0])
+    new_path = os.path.join(dest_dir, f"{project_name}.prproj")
+    os.rename(old_path, new_path)
+
+    return dest_dir
+
+
+def init_project(project_name: str, series_name: str | None, base_dir: str) -> int:
+    """CLI entry point: build the destination path and create the project,
+    printing a JSON result. Returns the process exit code."""
+    dest_dir = os.path.join(base_dir, series_name, project_name) if series_name else os.path.join(base_dir, project_name)
+
+    try:
+        create_project(project_name, dest_dir)
+    except RuntimeError as exc:
+        print(json.dumps({"ok": False, "error": str(exc)}))
+        return 1
+
+    print(json.dumps({"ok": True, "projectDir": dest_dir}))
+    return 0

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/src/premiere_cli/panel/.debug

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <ExtensionList>
-  <Extension Id="com.generativegamedev.premierebridge.panel">
+  <Extension Id="com.stefanwebb.premierecli.panel">
     <HostList>
       <Host Name="PPRO" Port="8088"/>
     </HostList>

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/src/premiere_cli/panel/CSXS/manifest.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<ExtensionManifest Version="7.0" ExtensionBundleId="com.generativegamedev.premierebridge" ExtensionBundleVersion="1.0.0" ExtensionBundleName="Premiere Bridge">
+<ExtensionManifest Version="7.0" ExtensionBundleId="com.stefanwebb.premierecli" ExtensionBundleVersion="1.0.0" ExtensionBundleName="Premiere Bridge">
   <ExtensionList>
-    <Extension Id="com.generativegamedev.premierebridge.panel" Version="1.0.0" />
+    <Extension Id="com.stefanwebb.premierecli.panel" Version="1.0.0" />
   </ExtensionList>
   <ExecutionEnvironment>
     <HostList>
@@ -15,7 +15,7 @@
     </RequiredRuntimeList>
   </ExecutionEnvironment>
   <DispatchInfoList>
-    <Extension Id="com.generativegamedev.premierebridge.panel">
+    <Extension Id="com.stefanwebb.premierecli.panel">
       <DispatchInfo>
         <Resources>
           <MainPath>./index.html</MainPath>

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/src/premiere_cli/panel/js/main.js

@@ -5,7 +5,7 @@ const PORT = 47823;
 // Kept in lockstep with the premiere-cli Python package version —
 // `premiere-cli doctor` compares the two and warns when the installed
 // panel is stale relative to the CLI that ships it.
-const PANEL_VERSION = '0.2.0';
+const PANEL_VERSION = '0.3.0';
 const VALID_LEVELS = ['info', 'warn', 'error'];
 
 // main.js is loaded via a plain <script src="js/main.js"> tag, not

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/src/premiere_cli/panel_install.py

@@ -16,7 +16,7 @@ import urllib.error
 import urllib.request
 from importlib import resources
 
-EXTENSION_ID = "com.generativegamedev.premierebridge"
+EXTENSION_ID = "com.stefanwebb.premierecli"
 DEFAULT_PORT = 47823
 
 # CSXS major versions to enable PlayerDebugMode for. Premiere 2020-2022 use

{premiere_cli-0.2.0 → premiere_cli-0.3.0/src/premiere_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: premiere-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: Drive Adobe Premiere Pro from the command line: a Python CLI plus a bundled CEP bridge panel exposing Premiere's scripting APIs over local HTTP
 License: CC-BY-SA-4.0
 Project-URL: Repository, https://github.com/stefanwebb/premiere-cli
@@ -22,16 +22,17 @@ ExtendScript / QE scripting APIs as ~230 JSON-in/JSON-out commands —
 reading project/sequence/clip state, editing the timeline, applying
 effects, managing markers and bins, exporting media and frames, and more.
 
-It is also a **Claude Code plugin**: install it and Claude gets a skill
-documenting every command, so it can inspect and edit your open Premiere
-project for you.
+The Claude Code skill for driving this CLI lives in the separate
+[premiere-ai-skills](https://github.com/stefanwebb/premiere-ai-skills)
+plugin, alongside the AI-assisted workflow skills — install that plugin
+to give Claude the skill.
 
 ## Install
 
 ```bash
 # 1. The CLI (isolated, no dependencies)
-pipx install git+https://github.com/stefanwebb/premiere-cli
-#    or: uv tool install git+https://github.com/stefanwebb/premiere-cli
+pipx install premiere-cli
+#    or: uv tool install premiere-cli
 
 # 2. The CEP panel (copies it into Adobe's extensions dir + enables PlayerDebugMode)
 premiere-cli install-panel
@@ -42,6 +43,10 @@ premiere-cli install-panel
 premiere-cli doctor
 ```
 
+`premiere-cli init-project <name> --base-dir <path>` scaffolds a fresh,
+empty `.prproj` from a bundled template — no Premiere Pro session needed,
+so it works before step 3.
+
 Supported: macOS and Windows (CEP does not exist on Linux). The panel
 targets Premiere Pro 2020+ (CEP 10-12); the API behavior notes in
 [docs/BUILD_FINDINGS.md](docs/BUILD_FINDINGS.md) were live-calibrated on
@@ -65,8 +70,8 @@ Every command prints a JSON object: `{"ok": true, "result": ...}` or
 ## Use from Claude Code
 
 ```
-/plugin marketplace add stefanwebb/premiere-cli
-/plugin install premiere-cli@premiere-cli
+/plugin marketplace add stefanwebb/premiere-ai-skills
+/plugin install premiere-ai-skills@premiere-ai-skills
 ```
 
 This gives Claude the `premiere-cli` skill — a complete, behavior-annotated

{premiere_cli-0.2.0 → premiere_cli-0.3.0}/src/premiere_cli.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 src/premiere_cli/__init__.py
 src/premiere_cli/cli.py
+src/premiere_cli/init_project.py
 src/premiere_cli/log.py
 src/premiere_cli/panel_install.py
 src/premiere_cli.egg-info/PKG-INFO
@@ -248,5 +249,7 @@ src/premiere_cli/panel/host/commands/update-marker.jsx
 src/premiere_cli/panel/host/presets/default-4k-25fps.sqpreset
 src/premiere_cli/panel/js/cs-interface.js
 src/premiere_cli/panel/js/main.js
+src/premiere_cli/templates/empty-project/Untitled.prproj
+src/premiere_cli/templates/empty-project/Adobe Premiere Pro Auto-Save/Untitled--8627e8e5-eccf-e7ea-8c87-b4de7f17596a-2026-07-10_12-30-47.prproj
 tests/test_cli.py
 tests/test_log.py