Build and revise procedural 3D assets with your coding agent. Local MCP server, CLI and TypeScript engine with rendered review, editable source and GLB export.
JavaScript 3d3d-assets3d-modelingagent-skillsagent-toolsai-agentsasset-pipelinecligame-assetsglbgltfmcpmcp-servermodel-context-protocolprocedural-generationprocedural-modelingtext-to-3dthreejstypescript
docs: record the history rewrite and how to recover an old clone
Matthew Kissingerfbc3da2df144
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex b798dd9b..9cbe991d 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -3,6 +3,29 @@Changes to `@kiln/engine`. Source and installable packages are distributed throughGitHub. The package is not published on the npm registry.+## Smaller clone; gallery images served from R2 — 2026-09-10++- Gallery renders and launch video are no longer carried in git history. A clone+ costs 35 MB on disk rather than 440 MB, and a plugin install no longer pays for+ 539 MB of repository content twice.+- The 88 gallery images moved to Cloudflare R2 byte for byte and are served from+ `assets.kilnstudio.tools`. Nothing was re-encoded: all 83 poster receipts still+ verify against the stored objects, and `scripts/verify-posters.mjs` checks that+ on every gallery build.+- **This rewrote history.** All 177 commits survived and the tree is unchanged+ apart from the removed images and video, but every commit hash changed. Clones+ predating this cannot fast-forward; see the note in `README.md`. Links pinned to+ an old commit SHA will stop resolving; links through `main` are unaffected.+- The launch video was never what the README served -- that comes from GitHub's+ asset CDN -- so the README is unaffected. `assets/gallery/` deliberately stays+ in the repository, so the README grid needs no network.+- Re-encoding the posters to shrink them was considered and rejected: image tokens+ scale with pixel dimensions, not file size, so it would have saved no agent+ context while voiding all 83 receipts.++Full record, including everything rejected and why, in+[docs/plans/repo-size-and-r2-migration-2026-09-10.md](docs/plans/repo-size-and-r2-migration-2026-09-10.md).+## Collections and chat viewing — 2026-09-06- Save assets into project or personal collections with immutable revisions,diff --git a/README.md b/README.mdindex bdc69260..f705ce8f 100644--- a/README.md+++ b/README.md@@ -80,6 +80,14 @@ bun run kiln render examples/crate.kiln.js --out crate.glb --views sheet.pngfile contents on the server, fetching them only if you ask for an old revision.A plain `git clone` also works and gives you the whole history up front.+History was rewritten on 2026-09-10 to drop 288 MB of gallery renders and launch+video that no tool reads, taking a clone from 440 MB to 35 MB on disk. Every+commit survived and the tree is unchanged apart from those files, but every+commit hash changed, so a clone made before that date cannot fast-forward.+Re-clone, or discard local history with `git fetch origin && git reset --hard+origin/main`. The gallery images are served from `assets.kilnstudio.tools`; the+83 poster receipts that attest their bytes stayed in `examples/renders/`.+This writes a GLB and a six-view image of an existing program. It makes no model call.Rendering uses the CPU unless a compatible local GPU service is available.Use `--render cpu` to select the CPU explicitly.