macOS CLI + Codex skill

3D models in. Clean PNGs out.

AssetShelf Renderer turns 3D files into reproducible single views, contact sheets, explicit subobject poses, and technical validation renders — directly from Terminal or in natural language with Codex.

Version 1.2 (Build 10) · 1.9 MB · signed & notarized · macOS

Green futuristic vehicle rendered from a GLB file as a transparent PNG with AssetShelf Renderer

One renderer, many workflows

Built for asset pipelines, not manual screenshots.

Consistent camera presets, output size, and surface settings: the CLI delivers repeatable results for catalogs, reviews, documentation, and automated production pipelines.

01 / AUTOMATION

Terminal-ready

Render individual files or entire folders without opening a 3D application.

02 / PBR

Materials preserved

Render textures, colors, and core PBR materials from FBX, glTF, and GLB.

03 / PARTS

Address authored nodes

--list-parts returns stable selectors and flags which logical FBX or GLB nodes are safely rotatable.

04 / POSES

Rotate only what you name

Apply explicit local X/Y/Z deltas by selector. No inferred joints, angle sweeps, or generated combinations.

05 / VIEWS

Large contact sheets

Render four or six views for every listed pose, with atomic pagination and a machine-readable cell index.

06 / QA

Inspect geometry

Mesh and rigging overlays expose technical issues, while the pivot marks the model's actual origin.

Render examples

Four-view contact sheet of a green futuristic vehicle rendered from an FBX file
FBX · contact-4 · Grid · 1600 × 1200 px

Contact sheets

One model. Four or six perspectives. One PNG.

Ideal for asset approvals and fast comparisons: front, back, left, and right — optionally including top and bottom.

Mesh diagnostic view of a red futuristic vehicle with its actual model pivot displayed
FBX · Mesh surface · Actual model pivot
Three explicitly listed HarborCrane poses, each rendered from four camera directions; only the turntable subtree changes orientation
FBX · 3 explicit poses · contact-4 · Stable shared framing · Build 10
  • FBX
  • OBJ
  • DAE
  • SCN
  • USD
  • USDA
  • USDC
  • USDZ
  • glTF
  • GLB
  • STL
  • PLY

The matching Codex skill

Describe what you need. Codex renders it.

The open-source skill knows the CLI's options, formats, sensible defaults, and common failure modes. It validates input, output, and the PNG signature, lists authored parts before selecting a node, and never guesses an ambiguous name or invents poses that were not requested.

  • “Render all FBX files as transparent 1024 px PNGs.”
  • “Create a four-view contact sheet for this GLB.”
  • “List the rotatable parts, then turn this named node 90° around local Y.”
Terminal · Install skill and render a model
git clone \
  https://github.com/TheGamby/assetshelf-renderer-codex-skill.git \
  ~/.codex/skills/assetshelf-render

assetshelf-render model.fbx --list-parts

assetshelf-render model.fbx \
  --output turntable-90.png \
  --rotate-part "path:fbx:23/fbx:27" "y=90" \
  --background "#101217"

Current download

AssetShelf Renderer CLI 1.2 (10)

Signed and notarized by Apple for macOS. The package installs the CLI at /usr/local/bin/assetshelf-render. Double-click the PKG to install; macOS Installer requests administrator authorization when needed. Version 1.2 can inspect logical FBX and GLB nodes with --list-parts, apply one explicitly requested pose with repeated --rotate-part, or render an ordered --pose-file. Larger jobs use --output-directory for bounded PNG pages and a contact-sheet.json index. Without either pose option, existing single renders and contact sheets remain unchanged. Third-party notices and the SPDX 2.3 SBOM are installed under /usr/local/share/doc/assetshelf-render/. The reviewed, source-built glTF subset remains free of KTX2/BasisU and Zstandard; content requiring BasisU or Draco is reported as unsupported. A missing optional FBX .fbm folder remains silent.

Import, render, and share only content for which you have the required rights. AssetShelf does not grant rights to opened content.

File: AssetShelf3DRenderCLI-1.2-10.pkg · 2,013,133 bytes (1.9 MB)
SHA-256: 547e0fd36bb4ae8df7b50abadce98d054d8bdf41380b839dbfcc909cf3a5f190
Download PKG