blender-inspect
An agent plugin that lets coding agents see what a Blender scene actually contains: depth, surface imperfections and topology defects, read from the scene itself rather than guessed from flat renders.
Agents modeling in Blender usually get orthographic, flat-lit renders with no depth data. Those hide flipped faces, dents, holes and interpenetrating parts. The scene already holds exact depth and topology; this plugin exposes it.
It ships alongside pil-agent-plugin in the same repository
and marketplace. pil-agent-plugin stays the image-measurement plugin;
blender-inspect is the home of the Blender tools.
Privacy and data sent
Everything runs locally in a headless Blender process. The plugin has no telemetry, hosted service, account or API key. See Privacy policy.
Requirements
- Python 3.11+ for the host-side wrapper scripts (standard library only)
- Blender (tested with Blender 5.2). The scripts find it in this order:
--blender-executable, theBLENDER_INSPECT_BLENDERenvironment variable,C:/Program Files/Blender Foundation/Blender 5.2/blender.exe, thenblenderonPATH.
Blender always runs with --factory-startup --background, so user add-ons and
preferences never load into an inspection run.
Layout
| Path | Role |
|---|---|
plugin.json | Portable Agent Plugins 1.0.0 manifest |
.claude-plugin/plugin.json | Claude Code manifest |
.codex-plugin/plugin.json | Codex manifest and interface metadata |
scripts/blender_common.py | Blender discovery, headless launch, sentinel parsing and the refusal contract shared by every blender_*.py tool |
skills/, agents/ | Skills and the inspector agent |
tests/ | test_bi_*.py; Blender-dependent tests skip when Blender is missing |
evals/ | claude plugin eval suite |
Every tool follows one refusal contract: when it cannot answer (no Blender,
unreadable .blend, a probe that did not finish cleanly) it exits 2 with
byte-empty stdout and a one-line reason on stderr.
Development
From the repository root:
uv run pytest -q plugins/blender-inspect/tests
Status
0.1.1 — skills trigger on plain requests. The model-inspection and
bootstrap skill descriptions were rewritten so the model picks them up from
ordinary asks ("check this .blend for holes", "which Blender will this use?")
without naming the plugin. model-inspection now hands inspections to the
blender-model-inspector agent instead of running them in the main thread.
Tools are unchanged apart from the version number.
0.1.0 — First release of blender-inspect. A second plugin in the
pil-agent-plugin marketplace that reads depth and defects from the Blender
scene itself: blender_mesh_audit (ten mesh-defect classes with locations),
blender_inspect_render (depth, normal, matcap, cavity and related modes from
one camera), blender_depth_order (which object is in front, per view), plus
the canonical blender_mesh, blender_fit, blender_render and
blender_multiview_render, the model-inspection and bootstrap skills and the
blender-model-inspector agent. The matching pil_blender_* copies in
pil-agent-plugin are deprecated. Evals are not shipped: claude plugin eval
refuses any case that grants Bash on Windows.
0.1.0 — Plugin scaffold and shared Blender launcher. First release of
blender-inspect as a second plugin in the pil-agent-plugin marketplace,
with the four-manifest set and scripts/blender_common.py.
License
MIT. See LICENSE.