reelkit-cli 0.12.5 → 0.12.6

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 What changed in each published version of `reelkit-cli`, newest first. A push to `main` publishes the version in
 `package.json` when it is not on npm yet, and it must have an entry here.
 
+## 0.12.6 - 2026-10-10
+
+- `reelkit template push` leaves out `.remotion` (the browser an older project rendered with) and `.cache`, and when a project is still over the limit it names the largest folders.
+
 ## 0.12.5 - 2026-10-09
 
 - The skill builds a film from component files instead of one long `Video.tsx`: every drawn part that could appear in another film is its own file in `src/`, so it can be reused and shows as a part of a template.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelkit-cli",
-  "version": "0.12.5",
+  "version": "0.12.6",
   "description": "CLI and Claude skill for making short-form video with a shared asset library.",
   "license": "MIT",
   "author": "Daniel Livshin",

package/skill/SKILL.md

@@ -15,7 +15,7 @@ For image or video cutouts, editable Blender product shots, custom 3D materials,
 
 To implement a chosen style, read its row in `reference/style-recipes.md` for action, timing, sound and proof. `reference/style-components.md` maps the shared components and built-in kit to shot roles; inspect the selected source before using its props.
 
-This skill targets `reelkit-cli` 0.12.5 and its HyperFrames kit. Check the installed version with `reelkit --version`; in a source checkout, invoke its `bin/reelkit.mjs` with Node. Use the matching CLI before authoring with `reelkit/frame`.
+This skill targets `reelkit-cli` 0.12.6 and its HyperFrames kit. Check the installed version with `reelkit --version`; in a source checkout, invoke its `bin/reelkit.mjs` with Node. Use the matching CLI before authoring with `reelkit/frame`.
 
 ## What decides whether the film is accepted
 

package/src/commands/template.ts

@@ -21,7 +21,8 @@ const sh = promisify(execFile);
 // What is sent: the project folder as one archive (the plan, the composition, and every file under assets/, including the user's own
 // pictures, footage and the recorded voice), the rendered video when there is one, and a small picture of each scene. What is left on
 // this machine: out/ (renders and previews), refs/ (reference videos), caches and node_modules.
-export const TEMPLATE_SKIP = ["out", "refs", ".reelkit", "node_modules", ".git", ".DS_Store"];
+// .remotion is where a project made before 0.10 kept the browser it rendered with: hundreds of megabytes that are not the project.
+export const TEMPLATE_SKIP = ["out", "refs", ".reelkit", ".remotion", ".cache", "node_modules", ".git", ".DS_Store"];
 const VIDEO = "out/video.mp4";
 // Where a project remembers the template it was cloned from, and the last one it was pushed as. Never part of a bundle.
 const LINK = ".reelkit/template.json";
@@ -156,6 +157,13 @@ export function filesOf(dir: string): { files: TemplateFile[]; sources: Uint8Arr
   return { files, sources: sources && sources.length <= MAX_TEMPLATE_SOURCES_BYTES ? sources : undefined };
 }
 
+// The three largest things at the top of the project, for the message that says a project is too large to push.
+function largest(dir: string): string {
+  const size = (path: string): number => { try { const st = statSync(path); return st.isDirectory() ? readdirSync(path).reduce((sum, name) => sum + size(join(path, name)), 0) : st.size; } catch { return 0; } };
+  const top = readdirSync(dir).filter((name) => !TEMPLATE_SKIP.includes(name)).map((name) => ({ name, bytes: size(join(dir, name)) })).sort((a, b) => b.bytes - a.bytes).slice(0, 3).filter((x) => x.bytes > 1_000_000);
+  return top.length ? `The largest parts: ${top.map((x) => `${x.name} (${mb(x.bytes)})`).join(", ")}. ` : "";
+}
+
 const readLink = (project: Project): { id?: string; from?: string } => { try { return project.readJsonOr<{ id?: string; from?: string }>(LINK, {}); } catch { return {}; } };
 
 export async function templatePush(ctx: Ctx, opts: { name?: string }): Promise<Result> {
@@ -171,7 +179,7 @@ export async function templatePush(ctx: Ctx, opts: { name?: string }): Promise<R
     ctx.log("Packing the project.");
     await sh("tar", ["-czf", bundle, ...TEMPLATE_SKIP.flatMap((x) => ["--exclude", `./${x}`]), "-C", project.dir, "."], { maxBuffer: 1 << 24 });
     const bundleBytes = statSync(bundle).size;
-    if (bundleBytes > MAX_UPLOAD_BYTES) return { ok: false, summary: `The project packs to ${mb(bundleBytes)}, over the ${mb(MAX_UPLOAD_BYTES)} a template may be. Remove large files under assets/ that the video does not use and push again.` };
+    if (bundleBytes > MAX_UPLOAD_BYTES) return { ok: false, summary: `The project packs to ${mb(bundleBytes)}, over the ${mb(MAX_UPLOAD_BYTES)} a template may be. ${largest(project.dir)}Move out what the video does not use and push again.` };
     const video = project.exists(VIDEO) ? project.path(VIDEO) : undefined;
     const videoBytes = video ? statSync(video).size : 0;
     if (videoBytes > MAX_UPLOAD_BYTES) return { ok: false, summary: `The rendered video is ${mb(videoBytes)}, over the ${mb(MAX_UPLOAD_BYTES)} limit. Export a smaller one with \`reelkit export\` or push without a render.` };