cli-anything-blender

A stateful command-line interface for 3D scene editing, following the same patterns as the GIMP CLI harness. Uses a JSON scene description format with bpy script generation for actual Blender rendering.

Installation

This CLI is installed as part of the cli-anything-blender package:

pip install cli-anything-blender

Prerequisites:

• Python 3.10+
• blender (>= 4.2) must be installed on your system

Usage

Basic Commands

# Show help
cli-anything-blender --help

# Start interactive REPL mode
cli-anything-blender

# Create a new scene project
cli-anything-blender scene new -o scene.blend-cli.json

# Run with JSON output (for agent consumption)
cli-anything-blender --json --project scene.blend-cli.json scene info

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

cli-anything-blender
# Enter commands interactively with tab-completion and history

Command Groups

Scene

Scene management commands.

Command	Description
new	Create a new scene
open	Open an existing scene
save	Save the current scene
info	Show scene information
profiles	List available scene profiles
json	Print raw scene JSON

Object Group

3D object management commands.

Command	Description
add	Add a 3D primitive object
remove	Remove an object by index
duplicate	Duplicate an object
transform	Transform an object (translate, rotate, scale)
set	Set an object property (name, visible, location, rotation, scale, parent)
list	List all objects
get	Get detailed info about an object

Material

Material management commands.