Installation

#Requirements

#Install the plugin

Both hosts install the same twelve specialist skills and local MCP server. Choose the commands for your host.

codex plugin marketplace add ifBars/blender-agent-studio
codex plugin add blender-agent-studio@blender-agent-studio

claude plugin marketplace add ifBars/blender-agent-studio
claude plugin install blender-agent-studio@blender-agent-studio

Inside a Claude Code session, you can also run /plugin marketplace add ifBars/blender-agent-studio followed by /plugin install blender-agent-studio@blender-agent-studio.

Start a new Codex task or Claude Code session afterwards so the skills and MCP server load. Ask the agent to check the Blender version with blender_version to verify the executable is available.

#Point it at Blender

Put blender on your PATH, or set BLENDER_EXECUTABLE to the executable:

export BLENDER_EXECUTABLE="/path/to/blender"

$env:BLENDER_EXECUTABLE = "C:\path\to\Blender\blender.exe"

MCP tools also accept a blenderPath argument, and benchmark commands accept --blender.

#Update

codex plugin marketplace upgrade blender-agent-studio
codex plugin add blender-agent-studio@blender-agent-studio

claude plugin marketplace update blender-agent-studio
claude plugin update blender-agent-studio@blender-agent-studio

Start a new task or session afterwards. If you built the scene analysis runtime, rebuild it too.

#Scene analysis runtime

Three tools use a small Rust executable for scene analysis. Build it once from the installed plugin directory, the one containing mcp, runtime, and package.json:

bun run setup:runtime

Or set BAS_RUNTIME_EXECUTABLE to a compatible bas-runtime build. Every other tool works without Rust.

#Skills only

To install the skills without the MCP server, use the skills CLI:

bunx skills add -g ifBars/blender-agent-studio --skill blender-agent-studio --agent codex -y

bunx skills add -g ifBars/blender-agent-studio --skill "*" --agent codex --full-depth -y

For Claude Code, replace --agent codex with --agent claude-code. This route installs skills without the MCP server or plugin presentation metadata.